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About the Tutorial 


Selenium is an open-source tool that is used for test automation. It is licensed 
under Apache License 2.0. Selenium is a suite of tools that helps in automating 
only web applications. 


This tutorial will give you an in-depth understanding of Selenium and its related 
tools and their usage. 


Audience 


This tutorial is designed for software testing professionals who would like to 
learn the basics of Selenium through practical examples. The tutorial contains 
enough ingredients to get you started with Selenium from where you can take 
yourself to higher levels of expertise. 


Prerequisites 


Before proceeding with this tutorial, you should have a basic understanding of 
Java or any other object-oriented programming language. In addition, you 
should be well-versed with the fundamentals of testing concepts. 


Copyright 8. Disclaimer 


O Copyright 2014 by Tutorials Point (1) Pvt. Ltd. 


All the content and graphics published in this e-book are the property of Tutorials Point 
(ID) Pvt. Ltd. The user of this e-book is prohibited to reuse, retain, copy, distribute or 
republish any contents or a part of contents of this e-book in any manner without written 
consent of the publisher. 


We strive to update the contents of our website and tutorials as timely and as precisely 
as possible, however, the contents may contain inaccuracies or errors. Tutorials Point (1) 
Pvt. Ltd. provides no guarantee regarding the accuracy, timeliness or completeness of 
our website or its contents including this tutorial. If you discover any errors on our 
website or in this tutorial, please notify us at contactOtutorialspoint.com 
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1. OVERVIEW 


Introduction 


Selenium is an open-source and a portable automated software testing tool for 
testing web applications. It has capabilities to operate across different browsers 
and operating systems. Selenium is not just a single tool but a set of tools that 
helps testers to automate web-based applications more efficiently. 


Let us now understand each one of the tools available in the Selenium suite and 
their usage. 


Tool Description 


Selenium IDE Selenium Integrated Development Environment 
(IDE) is a Firefox plugin that lets testers to record 
their actions as they follow the workflow that they 
need to test. 


Selenium RC Selenium Remote Control (RC) was the flagship 
testing framework that allowed more than simple 
browser actions and linear execution. It makes 
use of the full power of programming languages 
such as Java, C+*, PHP, Python, Ruby, and PERL to 
create more complex tests. 


Selenium WebDriver Selenium WebDriver is the successor to Selenium 
RC which sends commands directly to the browser 
and retrieves results. 


Selenium Grid Selenium Grid is a tool used to run parallel tests 
across different machines and different browsers 
simultaneously which results in minimized 
execution time. 
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Advantages of Selenium 


QTP and Selenium are the most used tools in the market for software 
automation testing. Hence it makes sense to compare the pros of Selenium over 
QTP. 


Selenium QTP 


Selenium is an open-source tool. (QTP is a commercial tool and there is a cost 
involved in each one of the licenses. 


Can be extended for various Limited add-ons and needs add-ons for 
technologies that expose DOM. each one of the technologies. 

Has capabilities to execute Can run tests in specific versions of Firefox, 
scripts across different IE, and Chrome. 

browsers. 


Can execute scripts on various Works only with Windows. 
operating systems. 


Supports mobile devices. Supports mobile devices with the help of 
third-party tools. 


Executes tests within the Needs Focus during script execution, as the 
browser, so focus is NOT tool acts on the browser (mimics user 
required while script execution is actions). 

in progress. 

Can execute tests in parallel QTP cannot execute tests in parallel, 


with the use of Selenium Grids. however integrating QTP with QC allows 
testers to execute in parallel. QC is also a 
commercial tool. 
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Selenium 


Let us now discuss the pitfalls of Selenium over QTP. 


Selenium 


Supports only web-based 
applications. 


No feature such as Object 
Repository/Recovery Scenario 


No IDE, so the script development 
won't be as fast as QTP. 


Cannot access controls within the 


browser. 


No default test report generation. 


For parameterization, users has to 


rely on the programming language. 
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Can test both web and desktop 
applications. 


QTP has built-in object repositories and 
recovery scenarios. 


More intuitive IDE; automation can be 
achieved faster. 


Can access controls within the browser 
such as favorites bar, backward, and 
forward buttons. 


Default test result generation within the 
tool. 


Parameterization is built-in and easy to 
implement. 


2. SELENIUM — IDE 


Selenium — IDE 


The Selenium-IDE (Integrated Development Environment) is an easy-to-use 
Firefox plug-in to develop Selenium test cases. It provides a Graphical User 
Interface for recording user actions using Firefox which is used to learn and use 
Selenium, but it can only be used with Firefox browser as other browsers are not 
supported. 


However, the recorded scripts can be converted into various programming 
languages supported by Selenium and the scripts can be executed on other 
browsers as well. 


The following table lists the sections that we are going to cover in this chapter. . 


Title Description 


Download Selenium This section deals with how to download and configure 
IDE Selenium IDE. 


Selenium IDE This section deals with the features available in 
Features Selenium IDE. 


Creating Selenium This section deals with how to create IDE tests using 
IDE Tests recording feature. 


Selenium IDE Script This section deals with debugging the Selenium IDE 
Debugging script. 


Inserting This section describes how to insert verification points in 
Verification Points Selenium IDE. 
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Selenium Pattern This section deals with how to work with regular 
Matching expressions using IDE. 

Selenium User The Java script that allows users to customize or add 
Extensions new functionality. 

Different Browser This section deals with how to execute Selenium IDE 
Execution scripts on different browsers. 


Download Selenium IDE 


Step 1 : Launch Firefox and navigate to the following URL — 
http://seleniumhq.org/download/. 


Under the Selenium IDE section, click on the link that shows the current version 
number as shown below. 


SÍ . fi is page searc selenium: MI 
E SeleniumHQ sia eE — 


Browser Automation Projects MATUTE Documentation Support About 


Downloads 


Below is where you can find the latest releases of all the Selenium components. You can also find a 
Latest Releases list of previous releases, source code, and additional information for Maven users (Maven is a popular 
Java build tool). 


Selenium Downloads 


Previous Releases 
Source Code Selenium IDE 


Selenium IDE is a Firefox plugin which records and plays back user interactions with the browser. Use 
this to either create simple scripts or assist in exploratory testing. It can also export Remote Control 
or WebDriver scripts, though they tend to be somewhat brittle and should be overhauled into some 
Donate to Selenium sort of Page Object-y structure for any kind of resiliency. 


3 Download latest released versión 2.5.0 reldased on 01/Jan/2014 or view the Release Notes and then 
with PayPal mp IAS 


install some plugins. 
Donate 


AA SEE 


Maven Information 


Download version under development unreleased (currently disabled) 


Step 2 : Firefox add-ons notifier pops up with allow and disallow options. User 
has to allow the installation. 


/ 


/ 


há Downloads (+ 


€ Kk 9 docsseleniumhq.org/download, 


E Ak Firefox prevented this site (docs.seleniumhq.org) from 
asking you to install software on your computer. 


A 
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Step 3 : The add-ons installer warns the user about untrusted add-ons. Click 
'Install Now”. 


Software Installation 


Install add-ons only from authors whom you trust. 


Malicious software can damage your computer or violate your privacy. 


You have asked to install the following 5 items: 


Selenium IDE: Ruby Formatters (Author not verifica) 
http://release.seleniumhq.org/selenium-ide/2.5.0/selenium-ide-2.5.0.xpi 


Selenium IDE ¡Author not verifiza) 
http://release.seleniumhq.org/selenium-ide/2.5.0/selenium-ide-2.5,0.xpi 


Selenium IDE: Python Formatters (Author not verified) 


http://release.seleniumhq.org/selenium-ide/2.5.0/selenium-ide-2.5.0.xpi 


[insatow] | Cancel 


Step 4 : The Selenium IDE can now be accessed by navigating to Tools >> 
Selenium IDE. 


Ele Edk View Histoy Bookmarks [1005] 


J QU) Mozilla Firefox Start Page Downloads  Ctrl+) 
; | Add-ons Ctrl+Shift+4 


E) Firefox | Search or enter addres Set Up Sync... 


12) Most Visited Í | Getting Started |; Web Developer 
| Page Info 


Options 


Step 5 : The Selenium IDE can also be accessed directly from the quick access 
menu bar as shown below. 


SIMPLYEASYLEARNING 
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Features of Selenium IDE 


The following image shows the features of Selenium IDE with the help of a 
simple tooltip. 


8 Selenium IDE 2.5.0 
Main Menu ile Edit Actions Options Help 


Base URL 


Test Case 


Untitled 


Command 


Test Suite 
Pane : Test Script 
E Pane 


Command 


A | Tee 


Runs: 0 


Value 


Failures: 


| Log | Reference | Ul-Element | Rollup | Infor Clear 


The features of the record tool bar are explained below. 


This helps in controlling the speed ofthe test case 
runs. 


» Executes the entire test suite that contains multiple 
test cases. 
A Allows user to pause or resume the script 
execution. Enabled only during the execution. 
Helps user to debug the test by executing only one 
step of a test case at a time. 


Allows user to execute the test case in a browser 
Test Runner Mode loaded with the Selenium-Core. Itis an obsolete 

functionality that is likely to be deprecated. 

This feature allows repetitive sequences of 


Apply Rollup Rules Selenium commands to be grouped into a single 
action. 


This feature helps user to Records the user's 
Record 
browser actions) 


Speed Control 
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Creating Selenium IDE Tests 


The following steps are involved in creating Selenium tests using IDE: 
e Recording and adding commands in a test 
e Saving the recorded test 
e Saving the test suite 


e Executing the recorded test 


Recording and Adding Commands in a Test 
We will use www.ncalculators.com to demonstrate the features of Selenium. 


Step 1: Launch the Firefox browser and navigate to the website - 
http://www.ncalculators.com/ 


Step 2: Open Selenium IDE from the Tools menu and press the record button 
that is on the top-right corner. 


, Selenium IDE 2.5.0 Lo JO aa 
File Edit Actions Options Help 


Base URL http://www.calculator.net/ 


bd 
y Slow >E p= | e O 
— j — pa > añ 
Test Case — ||| Table |Source| 
Untitled r F 
Command Target Value 
Pis 
Ik 
| Command - 
A | Target y Select Find 
Runs; 0 Value 
Failures; o¡| o 
| Log | Reference | Ul-Element | Rollup | Infor Clear 
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Step 3 : Navigate to "Math Calculator" >> "Percent Calculator >> enter "10" as 
numberl1 and 50 as number2 and click "calculate". 


MW, Pescent Coboclator 


€ lí cadclator net 


E) Most Vaned Getting Marted Saggostes lane Web Hice Catery Mew Tab 


Calculator.net 


e /Walr Calecmtors ) le ala! 

» Financial Calcularors 

Percent Calculator 
5 e 

D Véeight Loss Calculasars Plaose Mi any teo belds in the telling percentage calctater and Oct Pe “Taloutate" buon to gal 

Me trard value 

Y Math Cniculdatora 


> Icsareme Calculador Result 


> Error Calc 10% 0120 = 5 


» Purcent Caicuimor 
> Timo Caltus CA X Calculato ») 


Step 4 : User can then insert a checkpoint by right clicking on the webelement 
and select "Show all available commands" >> select "assert text css=b 5” 


Erre 
+n Modan re 


Y wat ved a Mr deta | A 
Calculator.net 


» emma l 


Parcent Calculator 


a] 
Dag E a 

mr hrol tea! » ¡Meade Bcc Bra 
iaa tao som pere cb Det e Le do Mn Br 


hos seta. Paca € slo 


sra e 
Ly a 
” TS 


Via rra Ca os Terrara Cr 
rl a 
pue Degree 
bl la rm 
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A A 
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Step 5: The recorded script is generated and the script is displayed as shown 
below. 


8 Selenium IDE 2,5.0 * 
File Edit Actions Options Help 
Base URL http://www.calculator.net/. 


Test Case | | Table | Source 


Untitled * [ 


Command 


xpath=(//a[containsíted(),'Math')])(2] 


clickAndWait link=Percent Calculator 
type id=cparl 

¡type id=cpar2 

clickAndWait css=input[type="image"] 
assertText ess=b 


Saving the Recorded Test 

Step 1: Save the Test Case by navigating to "File" >> "Save Test" and save the 
file in the location of your choice. The file is saved as .HTML as default. 

The test can also be saved with an extension htm, shtml, and xhtml. 


(8 Selenium IDE 2,5.0 * 
File Edit Actions Options Help 
Base URL http://www,calculator.net/ 


Test Case Table | Source | — 


Untitled * 


Command 


/ 
xpath=(//a[contains(text(), Math')])[2] 
clickAndWait link=Percent Calculator 


type id=cparl 


¡type id=cpar2 


clickAndWait css=input[type="image"] 
assertText css=b 
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Saving the Test Suite 


A test suite is a collection of tests that can be executed as a single entity. 


Step 1: Create a test suite by navigating to "File" >> "New Test Suite" as 
shown below. 


8 Selenium IDE 2.5.0 

Edit Actions Options Help 
New Test Case Ctrl+N / 
Open... Ctrl+0O 
Save Test Case Ctrl+S 
Save Test Case As... 
Export Test Case As... | Command 


Recent Test Cases 


Add Test Case... Ctrl+D 


Properties... 


Open Test Suite... 

Save Test Suite 

Save Test Suite As... 

Export Test Suite As... > 


Recent Test Suites » 


Close (X) Ctrl+W 


Command 


A | Tee 


Runs: 


Value 


Failures: 


| Log | Reference | Ul-Element | Rollup | Infor Clear 


Step 2: The tests can be recorded one by one by choosing the option "New Test 
Case" from the "File" Menu. 


Step 3: The individual tests are saved with a name along with saving a "Test 
Suite". 
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E, math_calculator.html - Selenium IDE 2.5.0 [o /:2-] 653 
File Edit Actions Options Help 
Base URL  http://www.calculator.net/ y 
== Slow >= p= | e) O 
y | [Table | Source 
math_calculator 
Command Target Value 
math_calculator_1 - 
open A 
clickAndWait //div[Qid="menu'J/div[3]/a/img 
clickAndWait link=Percent Calculator 
type id=cparl 10 
type id=cpar2 50 
Two Tests clickAndWait css=input[type="image"] 
yu a Test assertTexdt css=b 5 
Suite 
Command y 
A | Tee y| | Select Find 
Runs: Value 
Failures: 
| Log | Reference | Ul-Element | Rollup | Info» Clear 
Executing the Recorded Test 


The recorded scripts can then be executed either by clicking "Play entire suite" 
or "Play current test" button in the toolbar. 


Step 1: The Run status can be seen in the status pane that displays the 
number of tests passed and failed. 


Step 2 : Once a step ¡s executed, the user can see the result in the "Log" Pane. 


Step 3: After executing each step, the background of the test step turns 
"Green" if passed and "Red" if failed as shown below. 
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él, math_calculator_1.html - Selenium IDE 2.5.0 
File Edit Actions Options Help 
Base URL http://www.calculator.net/ 


SS Slow pS p= 


Ko) 


Test Case 


Imath_calculator 


C Run Status ) 


o 


a 


math_calculator_1 


| Table | Source 


Selenium 


LeJLo sa 


4 


Command 


Target 


Value 


¡Spen 


clickAndWait 
clickAndWait 
type 
click 
clickAndWait 


la 3 serte 


"a 


G 


/ 
xpath=(//a[contains(text(),'Math')))[2] 
link=Log Calculator 

name=yvw 
xpath=(//input[Qname='base'])[2] 


css=input[type="image"] 


"E 
— Highlighted in'Green' ifPassedor 
in'RED' if Failed 


Command 
Target 


Value 


Select 


Find 


[info] Executing: 
[info] Executing: 
[info] Executing: 
[info] Executing: 
[info] Executing: 
| [info] Executing: 
info] Changed test case 


IclickAndWait | //div[QOid="menu'J/div[3]/a/ima | | 
IclickAndWait | link=Percent Calculator | | 


ltype | id=cpari | 10 | 
Itype | id=cpar2 | 50 | 


IclickAndWait | css=input[type="image”] | | 


lassertText | css=b | 5 | 


Execution 


fmnTo 8 


Script Debugging 


Log of the the 


Infor Clear 


| 
wi | 


Debugging is the process of finding and fixing errors in the test script. 


It is a 


common step in any script development. To make the process more robust, we 
can use a plugin "Power Debugger" for Selenium IDE. 


Step 1: 


To 


install 


Power 


Debugger 


for Selenium IDE, 


navigate to 


https://addons.mozilla.org/en-US/firefox/addon/power-debugger-selenium-ide/ 
and click "Add to Firefox" as shown below. 


Y 
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A Pons Deza (Satervare 10 4 
- ree roda cry, 


¡2 Mos tited AI date Tap porta dm Web Ber aber hara Tabo 


mozilla » 


8 ADD-ONS'—— A 


Mer » Power Delegar Chelenzara TIT 


Power Debugger (Selentum IDE) 
L by Garrir Has 


A plugin for Seleniurm-1DE 10 improve debugziog and truubleshooting issues with 
snps 


sita) 


Step 2 : Now launch 'Selenium IDE' and you will notice a new icon, "Pause on 
Fail" on the recording toolbar as shown below. Click it to turn it ON. Upon 
clicking again, it would be turned "OFF", 


Y Selenium IDE 2.5.0 
File Edit Actions Options Help 
Base URL http://www.calculator.net/ 
9 =(m) => »= | e 


Table | Source 


Command 


Test Case 
Untitled 


| Pause on fail 


Command 


oo Select 
Runs: 0 


Failures: 0 


| Log L Reference | UL-Element | Roll | Info” Clear 


14 


SIMPLYEASYLEARNING 


ES tutorialspoint 


Selenium 


Step 3 : Users can turn "pause on fail" on or off any time even when the test is 
running. 


Step 4: Once the test case pauses due to a failed step, you can use the 
resume/step buttons to continue the test execution. The execution will NOT be 
paused if the failure is on the last command of any test case. 


Step 5: We can also use breakpoints to understand what exactly happens 
during the step. To insert a breakpoint on a particular step, "Right Click" and 
select "Toggle Breakpoint" from the context-sensitive menu. 


(Él) math_calculator.html - Selenium IDE 2.5.0 
File Edit Actions Options Help 
Base URL http://www.calculator.net/ 


ES Slow 1 pS »= [ y | E 


Test Case Table | Source 


math_calculator 
Command Target 


open / 

clickAndWait ¿dw[Wid="menu']/div... 

clickAndWait link=Percent Calculator 

type id=cparl 10 

type —id=ecnar? 50. 

clickAndWait | Ctrl+X 

assetText Ctrl+ € 
Ctri+V 
Del 


Insert New Command 


Insert New Comment 


Clear All 


Command type 


A | Tee ió=cpa 


Runs: 01| value 50 
Failures; 


| Log | Reference | UEElement | Rollup | Info” Clear 
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Step 6 : Upon inserting the breakpoint, the particular step is displayed with a 
pause icon as shown below. 


' él, math_calculator.html - Selenium IDE 2.5.0 
File Edit Actions Options Help 

Base URL http://www.calculator.net/ 
EL PEPA SPD O 


Test Case Table | Source | 


math_calculator 
Command Target 


[open / 

clickAndWait /div[Qid="menu']/div... 

clickAndWait link=Percent Calculator 
id=cparl 10 
id=cpar2 50 

clickAndWait ess=input[type="imag... 

assertText css=b 


Command open 


A | Tee / 


Runs: 


Failures: 


| Log | Reference UFElement | Rollup | 


open(url) 
Arguments: 
e url - the URL to open; may be relative or absolute 
Opens an URL in the test frame. This accepts both relative and absolute URLs. The "open" command waits for the 


Step 7 : When we execute the script, the script execution is paused where the 
breakpoint is inserted. This will help the user to evaluate the value/presence of 
an element when the execution is in progress. 
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Percent Calculator Eedd, «fyoiena- Qptnen » ddelp 
ES Pe 1 rs : Dove URL httgc/ ss caordator net. 
o 
Test Case Tato Sure 


rmeth_coludetor 
Cammand 


Selenium 


Targes 


open 
hdd 
hina 
pe 

2ltype 


cria 


mentar 


Script Execuliowm ís 


log  Reterence | Ul-Ajemera | Hollup 


[mto) Execurama: open | / 


Inserting Verification Points 


Al Did ren Y GMIY 4 img 
ink=Percent Calculator 
de cpel 
Spa? 
txt ingutltype="image”] 


essa b 


into- Clear 


[mfo] Executing: idickandWar | ¡dei dr menu lid 3Y arg 1 | 
[info] Executing: idickandWarn | irk=Percera Calodator 


The test cases that we develop also need to check the properties of a web page. 
It requires assert and verify commands. There are two ways to insert verification 


points into the script. 


To insert a verification point in recording mode, "Right click" on the element and 


choose "Show all Available Commands" as shown below. 
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Open Link in New Tab 

Open Link in New Window 

Open Link in New Private Window 
Bookmark This Link 

Save Link As... 

Copy Link Location 


Save Link with DownThemAll! 


Start saving Link with dTa OneClick! 


Search Google for "Math" 


Inspect Element (Q) 


Inspect Element with Firebug 


open /math-calculator,html 
assertTitle Math Calculators 


verify Value 


Selenium 


Show All Available Commands » 
A 


8, Selenium IDE 2,5.0* 
File Edit Actions Options Help 


Base URL http://www.calculator.net/ 


ds Slow M1] PE »p= 


Test Case 


Table 


|O 


open /math-calculator.html 


assertTitle Math Calculators 

assertValue 

assertText link=Math Math 

assertT able //table[2].0.0 Home / Math Calculators Math Calculators 


assertElementPresent link=Math 


verifyTitle Math Calculators 

verifyValue 

verify Text link=Math Math 

verifyTable //table[2].0.0 Home / Math Calculators Math Calculators 
verifyElementPresent link=Math 


waitForTitle Math Calculators 
waitForValue 


waitForText link=Math Math 


waitForTable //table[2].0,0 Home / Math Calculators Math Calculators 


waitForElementPresent link=Math 

storeTitle Math Calculators 

storeValue 

storeText link=Math Math 

storeTable //table[2].0.0 Home / Math Calculators Math Calculators 


storeElementPresent link=Math 


Source 


Put this m... 


Put this ma... 


Put this ... 


Put this ma... 


We can also insert a command by performing a "Right-Click" and choosing 
"Insert New Command". 


Untitled * 


Runs: 


Failures: 


ph 


Command 
open 
selectWindow 
clickAndWait 
selectWindow 
type 
selectWindow 
type 
selectWindow 
clickAndWait 


Target 
/math-calculator.html 
name=n15KfMuM 
link=Percent Calculator 
name=n15KfMuM 
id=cparl 
name=n15KfMuM 
id=cpar2> 


name=n 
Ctrl+C 


Ctrl+Y 
Del 


ess=inpt 


Command type 


Target 


Value 


id=cpar2 


50 Clear All 


[Log | Reference | -Ul-Element | Rollup | 


type(locator, value) 
Arguments: 
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Toggle Breakpoint B 
Set / Clear Start Point  S 


Execute this command X 
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After inserting a new command, click 'Command' dropdown and select 
appropriate verification point from the available list of commands as shown 
below. 


(8 Selenium IDE 2.5.0 + 
File Edit Actions Options Help 
Base URL http://www,calculator.net/ 


a Slow 1 PE p= | e 
Pe 


Test Case Table | Source 
Untitled * 


Cornmand Target 

open /math-calculator.html 
selectWindow name=n15KfMuM 
clickAndWait link=Percent Calculator 
selectWindow name=n15KfMuM 
type id=cparl 


selectWindow name=n15KfMuM 

type id=cpar2 

selectWindow name=n15KfMuM 
clickAndWait css=input[type="image"] 


Command 
q q=--ñl-IIIIAKX— | Target (HaddLocationStrategy 
addLocationStrategyAndWait 

Value addScript 
Failures: | addScriptAndWait 

, , = 4 addSelection 
| Log | Reference | UF Element | Rollup | addSelectionAndWait 
. Ñ ' Ñ allowNativeXpath 
allowNativeXpathAndWait 
altKeyDown 
altKeyDownAndWait 
altKeyUp 
altKeyUpAndWait 


Runs: 


answerOnNextPrompt 
ertÁlert 


Given below are the mostly used verification commands that help us check if a 
particular step has passed or failed. 


e verifyElementPresent 

e assertElementPresent 

e verifyElementNotPresent 
e assertElementNotPresent 
e verifyText 


e assertText 
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e verifyAttribute 
. assertAttribute 
. verifyChecked 
e assertChecked 
e verifyAlert 

e assertAlert 

e verifyTitle 


e. assertlitle 


Synchronization Points 


During script execution, the application might respond based on server load, 
hence it is required for the application and script to be in sync. Given below are 
a few commands that we can use to ensure that the script and application are in 
sync. 


e waitForAlertNotPresent 

e waitForAlertPresent 

e waitForElementPresent 

e waitForElementNotPresent 
e waitForTextPresent 

e waitForTextNotPresent 

e waitForPageToLoad 


e waitForFrameToLoad 


Pattem Matching 


Like locators, patterns are a type of parameter frequently used by Selenium. It 
allows users to describe patterns with the help of special characters. Many a 
time, the text that we would like to verify are dynamic; in that case, pattern 
matching is very useful. 


Pattern matching is used with all the verification point commands -— 
verifyTextPresent, verifyTitle, verifyAlert, assertConfirmation, verifyText, and 
verifyPrompt. 
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There are three ways to define a pattern: 
e globbing, 
e regular expressions, and 


e exact patterns. 


Globbing 


Most techies who have used file matching patterns in Linux or Windows while 
searching for a certain file type like *.doc or *.jpg would be familiar with term 
"globbing”. 


Globbing in Selenium supports only three special characters: *, ?, and [ ]. 
e *- matches any number of characters. 
e ?- matches a single character. 


e [ ]- called a character class, lets you match any single character found 
within the brackets. [0-9] matches any digit. 


To specify a glob in a Selenium command, prefix the pattern with the keyword 
'glob:'. For example, if you would like to search for the texts "tax year 2013" or 
"tax year 2014", then you can use the glob "tax year *" as shown below. 


However the usage of "glob:" is optional while specifying a text pattern because 
globbing patterns are the default in Selenium. 


Command Target Value 
clickAndWait link=search 
verify TextPresent glob: tax year * 
Exact Pattems 


Patterns with the prefix 'exact:' will match the given text as it is. Let us say, the 
user wants an exact match with the value string, ¡.e., without the glob operator 
doing its work, one can use the 'exact' pattern as shown below. In this example, 
the operator '*' will work as a normal character rather than a pattern-matching 
wildcard character. 
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Command Target Value 
clickAndWait link=search 
verifyValue exact: *.doc 


Regular Expressions 


Regular expressions are the most useful among the pattern matching techniques 
available. Selenium supports the complete set of regular expression patterns 
that Javascript supports. Hence the users are no longer limited by *, ?, and [] 
globbing patterns. 


To use RegEx patterns, we need to prefix with either "regexp:" or "regexpi:". 
The prefix "regexpi" is case-insensitive. The glob: and the exact: patterns are 
the subsets of the Regular Expression patterns. Everything that is done with 
glob: or exact: can be accomplished with the help of RegExp. 


Example 


For example, the following will test if an input field with the id 'name' contains 
the string 'tax year", "Tax Year", or 'tax Year'. 


Command Target Value 
clickAndWait link=search 
verifyValue id=name regexp:[Ttlax ([Yy]ear) 
Selenium User Extensions 


It is easy to extend Selenium IDE by adding customized actions, assertions, and 
locator-strategies. It is done with the help of JavaScript by adding methods to 
the Selenium object prototype. On startup, Selenium will automatically look 
through the methods on these prototypes, using name patterns to recognize 
which ones are actions, assertions, and locators. 
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Let us add a 'while' Loop in Selenium IDE with the help of JavaScript. 
Step 1 : To add the js file, first navigate to 


https://github.com/darrenderidder/sideflow/blob/master/sideflow.js and copy 
the script and place save it as 'sideflow.js' in your local folder as shown below. 


Computer » DataDisk(D:) » PERSONAL DOCS » Selenium TP » 


Include in library y Share with New folder 
Name 


selenium 


y references.bd 


Step 2 : Now launch 'Selenium I1DE' and navigate to "Options" >> "Options" as 
shown below. 


él, Selenium IDE 2.5.0 


l«—-][-5-](sé3a) 
File Edit Actions [QntinnslóHelo === 
Base URL http:// ' + 
ES Slow ” SOBRA (5 
rabia Clipboard Format 


lUntitled Reset IDE Window 


Clear history 


Command y 
A | Tee y| [_ Select Find 
| 
7 | 
Runs: | Value 


Failures: 0| 


| Log | Reference | ULElement | Rollup.| Infor Clear 
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Step 3 : Click the 'Browse' button under 'Selenium Core Extensions' area and 


point to the js file that we have saved in Step 1. 
Selenium IDE Options 


General Formats Plugins | Locator Builders | WebDriver 


Encoding of test files 
UTE-8 


30000 


DAPERSONAL DOCS Selenium TPisideflow.js 


Selenium IDE extensions 


You can specify multiple files separated by commas. 


Y] Remember base URL 


| Record assertTitle automatically 


[| Record absolute URL 


|| Activate developer tools 
[—] Enable experimental features 


[7] Disable format change warning messages 


[ 


Start recording immediately on open 


Default timeout value of recorded command in milliseconds (305 = 30000ms) 


Tips for extensions: Close and recpen Selenium IDE window to make changes effect. 


Browse... 


Browse... 


Step 4 : Restart Selenium IDE. 


Step 5 : Now you will have access to a few more commands such as "Label", 


"While", etc. 


Step 6 : Now we will be able to create a While loop within Selenium IDE and it 


will execute as shown below. 
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File Edit Actions Options Help 
Base URL ; http://www.calculator.net/ 
E Slow uE > 
Test Case 
try 


Sb3<10 
Value of x is $x 


new Number(storedVars['x'])+1 


Command store 


CS | Teee 


Runs: 1 


Value Xx 


Failures: 0 


| Log | Reference | UL-Element | Rollup Info” Clear 


Pt A td 


info] Executing: |echo | Value of x is $x | | 
| [info] echo: Value of x is $x 

[info] Executing: |storeEval | new Number(storedVars['x'])+1 | x | 

[info] script is: new Number(storedVars['x'])+1 


[info] Executing: JendWhile | | | 
| Einfo] Executing: while | $1x3<10 IN 


Different Browser Execution 


Selenium scripts can run tests only against Firefox as the tool IDE itself is a 
plugin of Firefox. Tests developed using Selenium IDE can be executed against 


other browsers by saving it as Selenium WebDriver or Selenium Remote Control 
Script. 


Step 1 : Open any saved Test in Selenium IDE. 
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Step 2: Navigate to "File" menu and select "Export Test Suite As" and the 
options would be listed. 


(Él, math_calculator.html - Selenium IDE 2,5.0 


Edit Actions Options Help 


New Test Case 
Open... 

Save Test Case 
Save Test Case As... 


Recent Test Cases 


Add Test Case... 


Properties... 


New Test Suite 
Open Test Suite... 
Save Test Suite 
Save Test Suite As... 


Recent Test Suites 


Close (0) 


AAA 
Runs: 1 


Failures: 


Ctrl+ IN 
Ctrl+0 
Ctrl+S 


Export Test Case As... 


Ctrl+D 


Export Test Suite As... 


Ctrl+WW 


/ 


//div[Qid="menu']/div[3]/a/img 
link=Percent Calculator 
id=cparl 

id=cpar2 
css=input[type="image"] 


css=b 


Ruby / RSpec / WebDriver 
Ruby / Test::Unit / WebDriver 


Ruby / / R5pec., / Remote Control 


Java / JUnit 4 / WebDriver Backed 


Java / JUnit 4 / Remote Control 
Java / JUnit 3 / Remote Control 
Java / TestWG / Remote Control. 
C2 / NUnit / WebDriver 


| Log | Reference ] Ul-Element | Rollup | 


A do UN A dl EU E 


[info] echo; Value of x is $x 


[info] Executing: |storeEval | new Number(storedVars['x')+1 | x |] 
[info] script is: new Number(storedVars['x'])+1 


[info] Executinga: |JendWhile | | | 


[info] Executing: |while | $4x3<10 | | 
| [info] Changed test case 


Infor Clear 


A 


Step 3 : Now let us export the script to "WebDriver" and save it with a name. 


Step 4 : The saved WebDriver file is displayed as shown below. 
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import junit.framework.Test; 
import junit.framework.TestSuite; 


GQ pb ps 


ds 


public class percentcalc ( 


O Y 


public static Test suite() ( 
TestSuite suite = new TestSuite(); 


suite.addTestSuite (math _calculator.class); 


return suite; 


public static void main(String[] args) ( 
junit.textui.TestRunner.run(suite()); 
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In order to develop Selenium RC or WebDriver scripts, users have to ensure that 
they have the initial configuration done. Setting up the environment involves the 
following steps. 


e Download and Install Java 

e Download and Configure Eclipse 
e Configure FireBug and FirePath 
e Configure Selenium RC 


e Configure Selenium WebDriver 


Download and Install Java 


We need to have JDK (Java Development Kit) installed in order to work with 
Selenium WebDriver/Selenium. Let us see how to download and install Java. 


Step 1: Navigate to the URL: 
http://www.oracle.com/technetwork/java/javase/downloads/index.html 


Step 2: Go to "Downloads" section and select "JDK Download". 


Overview Downloads Documentation Community Technologies Training 


Java SE Downloads 


= Java So NetBeans 


Java Platform (JDK) 8u11 JDK 8u11 £ NetBeans 8.0 


Java Platform, Standard Edition 


Java SE 8u11 

This release includes important security fixes. Oracle strongly recommends that all Java SE 8 
users upgrade to this release. 

Learn more » 


= Installation Instructions JDK a: 
DOWNLOAD + Ml 
» Release Notes , 


= Oracle License 


= Java SE Products Server JRE 
* Third Party Licenses OOWNEDAL > 


= Certified System Configurations 


-  Readme Files 
JRE 


= JDKReadMe 
DOWNLOAD + 


= JREReadMe 
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Step 3: Select "Accept License Agreement" radio button. 


| Ovemiew | Downloads | Documentation [| Community [| Technologies || Training 


Java SE Development Kit 8 Downloads 


Thank you for downloading this release ofthe Java TM“ Platform, Standard Edition Development Kit 


DK") The JDK is a development environment for building applications, applets, and 
components using the Java programming language. 


The JDK includes tools useful for developing and testing programs written in the Java 
programming language and running on the Java platform. 


See also: 


= Java Developer Newsletter (tick the checkbox under Subscription Center => Oracle Technology 
News) 


= Java Developer Day hands-on workshops (free) and other events 
= Java Magazine 
JDK MD5 Checksum 


Looking for JDK 8 on ARM? 
JDK 8 for ARM downloads have moved to the JDK 8 for ARM download page. 


¿“De 


Accept License ca *  Decline License Agreement 


Linuxx86 133.58 MB jak-8u11-linux-586.rpm 
Linuxx86 152.55 MB jak-8411-linux-i586.tar.oz 
Linux x64 133.89 MB jok-8411-linux-x64.rpm 
Linuxx64 151.65 MB jak-8u1 1-linux-x54.tar.gz 

Mac OS X x64 207.82 MB jdak-8u11-macosx-x54.dmg 
Solaris SPARC 64-bit (SVR4 package) 135.66 MB jdk-8u11-solaris-sparcv9.tar.Z 
Solaris SPARC 64-bit 96.14 MB Y ¡dk-8u11-solaris-sparcv9.tar.oz 
Solaris x64 (SVR4 package) 135.7 MB $ ¡dk-8u11-solaris-x64.tar.Z 
Solaris x64 93.18MB + jdk-8u11-solaris-x64.tar.0z 
Windows x86 151.81MB_ $ jdk-8u11-windows-i586.exe 
Windows x64 155.29MB_ $ jok-8u11-windows-x64.exe 
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Step 4 : Select the appropriate installation. In this case, it is "Windows 7-64" bit. 
Click the appropriate link and save the .exe file to your disk. 


Java SE Develop 


ent Kit 8111 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 


software. 


Thank you for accepting the Oracle Binary Code License Agreement for Java SE; you may now 
download this software. 


Product / File Description 


Linuxx86 

Linuxx86 

Linux x64 

Linux x64 

Mac OS X x64 

Solaris SPARC 54-bit (SVR4 package) 
Solaris SPARC 64-bit 
Solaris x64 (SVR4 package) 
Solaris x64 

Windows x86 

Windows x64 


losa UM E 


133.58 MB 
152.55 MB 
133.89 MB 
151.65 MB 
207.82 MB 
135.56 MB 
96.14 MB 

135.7 MB 

93.18 MB 

151.81 MB 


155.29 MB 


$ jdk-8u11-linux-i586.rpm 
jdk-8u11-linux-¡586.tar.gz 
jak-8u11-linux-x64.rpm 
jdak-8u11-linux-x64.tar.gz 

$ jdk-3u11-macosx-x64.dmg 

$ ¡dk-8u11-solaris-sparcv9.tar,.Z 

$ ¡jdk-8u11-solaris-sparcv9.tar.gz 

$ jdk-8u11-solaris-x64.tar.Z 

$ ¡dk-3u11-solaris-x64.tar.gz 


3 ¡dk-8u11-windows-1586.exe 
X jak-8u11-windows-x64.exe _, 


Step 5 : Run the downloaded exe file to launch the Installer wizard. Click 'Next' 


to continue. 


a Java SE Development Kit 8 Update 11 (64-bit) - Setup 


ORACLE 


Welcome to the Installation Wizard for Java SE Development Kit 8 


This wizard will guide you through the installation process for the Java SE Development 


Kit 8. 


The Java Mission Control profiling and diagnostics tools suite is now available as part of 
the JDK. 
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Step 6 : Select the features and click 'Next'. 


Selenium 


His) Java SE Development Kit 8 Update 11 (64-bit) - Custom Setup 


ORACLE 


Select optional features to install from the list below. You can hange your choice of features after 
installation by using the Add/Remove Programs utility in the Control Panel 


E y | Public JRE 


Install to: 
C: Program Filesavaljdk1.8,0_111 


Step 7 : The installer is extracted and its progress is shown in the wizard. 


Ns Java SE Development Kit 8 Update 11 (64-bit) - Progress 


Status: Extracting Installer 


Feature Description 


Java SE Development Kit 8 
Update 11 (64-bit), induding the 
JavaFX SDK, a private JRE, and 
the Java Mission Control tools 
suite. This will require 180MB on 
your hard drive. 


ORACLE 


La 
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Step 8 : The user can choose the install location and click 'Next'. 


1) Java Setup - Destination Folder 


ORACLE 


Install to: 


C: Program Files Java!jre8! | Change... 


y Java Setup - Progress 


$ 
E ENTER ORACLE 


Copying new files 


3 Billion Devices Run Java 


ORACLE 
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Step 10 : The Installer installs successfully and displays the same to the user. 


y Java SE Development Kit 8 Update 11 (64-bit) - Complete 


ORACLE 


Java SE Development Kit 8 Update 11 (64-bit) Successfully Installed 


Click Next Steps to access tutorials, API documentation, developer guides, release notes 
and more to help you get started with the JDK, 


Next Steps 


Step 11 : To verify if the installation was successful, go to the command prompt 
and just type 'java' as a command. The output of the command is shown below. 
If the Java installation is unsuccessful or if it had NOT been installed, it would 
throw an "unknown command" error. 


MC AWindow yytemiTcomd.exe =)- [tam 


ble verbuss 
nt product 


' clazine 
iith specified granularity 


libnane?. e.y spent 1ib: hpral 


1ry 
w=he lp and —agent 14h: hyrof =he 1 y 


library hy full patihinan 
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Download and Configure Eclipse 


Step 1 : Navigate to the URL: http://www.eclipse.org/downloads/ and download 
the appropriate file based on your OS architecture. 


eclipse 


PACKAGES — JAVA”" 8 SUPPORT 


Eclipse Luna (4.4) Release for 


Eclipse Standard 4.4 


Downloaded 955,976 Times Other Downloads A 
Í JL Windows 32 Bit 
N Standard Eclipse package suited for Java and plug-in development plus 2eB indows 64 Bit 

adding new plugins; already includes Git, Marketplace Client, source code 

and... 


Step 2 : Click the 'Download' button. 


S eclipse 


DADS / ECLIPSE DOWNLOADS - MIRROR SELECTION 


Downloads Home 


a Eclipse downloads - mirror selection 


All downloads are provided under the terms and conditions of the Eclipse Foundation 
Software User Agreement unless otherwise specified. 


More Packages 


Download eclipse-standard-luna-R-win32-x86_64.zip from: 


Give Back to [China] Beijing Institute of Technology (http) 
Eclipse Checksums: [MD5] [SHA1] [SHA-512] 


$5 $15 ...0r pick a mirror site below. 


34 


Y) tutorialspoint 


Selenium 


Step 3 : The download would be in a Zipped format. Unzip the contents. 


y » Computer » DataDisk(D:) » PERSONAL DOCS » Eclipse » 


Ev Include in library + Share with w New folder 


” 


Name Date modified Type 


26/07/2014 10:49 ... — Filefolder 
WinRAR ZIP archive 210,750 KB | 


eclipse-standard-luna-R-win32-x86_64 
7] eclipse-standard-luna-R-win32-x86_64.zip 26/07/2014 10:43 ... 


Step 4 : Locate Eclipse.exe and double click on the file. 


1 < DataDisk (D:) » PERSONAL DOCS » Eclipse » eclipse-standard-luna-R-win32-x86_64 » eclipse » 


” Include in library Y Share with New folder 


y3 


Name Date modified Type 


7 configuration 12/06/2014 4:08 AM File folder 
 dropins 12/06/2014 4:08 AM File folder 
features 12/06/2014 4:08 AM File folder 

, p2 12/06/2014 4:07 AM File folder 


plugins 12/06/2014 4:08 AM File folder 


o readme 12/06/2014 4:08 AM  Filefolder 


| .eclipseproduct 
artifacts.xml 

=> eclipse.exe 
eclipsec.exe 

2 | epl-v10.html 


2 | notice.html 
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4/06/2014 8:06 PM 
12/06/2014.4:08. AM 
12/06/2014 4:08 AM 


12/06/2014 4:08 AM 
4/06/2014 8:13 PM 
4/06/2014 8:06 PM 


ECLIPSEPRODUCT... 
XAML Document 
Application 
COmtduration E 
Application 
HTML Document 


HTML Document 


En 
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Step 5 : To configure the workspace, select the location where the development 
has to take place. 
S Workspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


DAPERSONAL DOCS1Selenium Trials 


[| Use this as the default and do not ask again 


Sesech  Preyaar Run Window Help 


Welcome to Eclipse 


Overview Tutorials 


Get an overnew ol the tratures Go through tutorials 


Samples What's New 


Try aut the campóos Pa out ahat a ne 


Configure FireBug and FirePath 


To work with Selenium RC or WebDriver, we need to locate elements based on 
their XPath or ID or name, etc. In order to locate an element, we need 
tools/plugins. 


Step 1 : Navigate to the URL: https://addons.mozilla.org/en- 
US/firefox/addon/firebug/ and download plugin. 
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', ADD-ON 


EXTEMSIONS | THEIATS 


RÁ» Extensions » Firebor 


e Firebug 2.02 Ea 
by Joc H 


ewitt, Jan Odvarko, robeee, Firebug WorlaneGron; 


Firebug integrates with Firefox to put a wealth of development tools at your fingertips 


while you browse. You can edit, debug, and monitor CSS, HTML, and JavaScript live in 


Enjoy this add-on? 


The dereloper al this add on asks that you show your support by making a donation 
to the Monslla Foundation. 


Step 2: The add-on installer is shown to the user and it is installed upon 
clicking the 'Install' button. 


Install add-ons only from authors whom you trust. 


Malicious software can damage your computer or violate your privacy. 


You have asked to install the following item: 


Firebug (Author not verified) 
https://addons.mozilla.org/firefox/ dowhloads/latest/1843/addon-1843-latest.xpi?src= 
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Step 3: After installing, we can launch the plugin by navigating to "Web 
Developer” >> "Firebug". 


[Ez] Percent Calculator —X O: Downloads  Ctri+) m loading p.. | (O) getText( on eleme... 
Add-ons Ctri+Shift+A y 
€ A Mozilla Foundation (US) | https Set Up Sync... Bdon/firepath 


12) Most Visited || Getting Started Web Developer e. Firebug 


Page Into 


Toggle Tools 


Options Web Console Ctrl+Shift+K 

E  DownThemAll! Tools Inspector Ctrl+Shift+C 

El SeleniumIDE  Ctri+Alt+S Debugger Ctrl+Shift+S 
Style Editor Shift+F7 
Profiler Shift+F5 

Mi» ExtensionsA Network Ctrl+Shift+Q 


Developer Toolbar Shift+F2 


App Manager 
ud Browser Console Ctrl+Shift+J 
Responsive Design View  Ctrl+Shift+1I 


Scratchpad Shift+F4 
Page Source CtrI+U 


Get More Tools 
+ Add to Firefox 


Step 4 : FirePath, a plugin that works within Firebug, helps users to grab the 
'XPath' of an element. Install FirePath by navigating to 
"https://addons.mozilla.org/en-US/firefox/addon/firepath/” 


mozilla » 


EXTEMSIOMS MHAIMES COLLECTIONS MORE 


Ñ >» Extensiona » FirePath 


10 USET TOVIEWS 


Li! Te 
e SS 


47,127 users 4 
FirePath is a Firebug extension that adds a development tool to edit, inspect and 

generate XPath 1.0 expressions, CSS 3 selectors and JQuery selectors (Sizzle selector 

engine), 


+ Add to Firefox. 
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Step 5: The add-on installer is shown to the user and it is installed upon 
clicking the 'Install' button. 


Software Installation 


Install add-ons only from authors whom you trust. 


Malicious software can damage your computer or violate your privacy. 


You have asked to install the following itern: 


FirePath (Author not verified) 
hdd https: //addons.mozilla,org/firefoxdownloads/latest/11900/addon-11900-latest.xpi?sr 


Install (1) Cancel 


Step 6 : Now launch "Firebug" by navigating to "Tools" >> "Webdeveloper" >> 
"Firebug". 


AX mi ps mn e 
RdA pus a 


a o 10 
a 
A ¡= cto AS 
A e e A ri 
tora ee eta Gap 900 rr Creada a q rr rad 


E 


Example 


Now let us understand how to use FireBug and FirePath with an example. For 
demonstration, we will use www.google.com and capture the properties of the 
text box of "google.com". 


Step 1 : First click on the arrow icon as highlighted in the following screenshot 
and drag it to the object for which we would like to capture the properties. The 
HTML/DOM of the object would be displayed as shown below. We are able to 
capture the 'ID' of the input text box with which we can interact. 
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properties of he 


search tert lor - id 


Step 2 : To fetch the XPath of the object, go to 'firepath' tab and perform the 
following steps. 


e Click the Spy icon. 
e Select the Control for which we would like to capture the XPath. 


e XPath of the selected control would be generated. 


Configure Selenium RC 


Now let us look at how to configure Selenium Remote control. We will 
understand how to develop scripts with Selenium RC in later chapters, however 
for now, we will understand just the configuration part of it. 


Step E Navigate to the Selenium downloads section 
http://www.seleniumhq.org/download/ and download Selenium Server by 
clicking on its version number as shown below. 
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EY seleniumHQ scorch sctentom IO (o 


Browser Automation Download MAA a 


Downloads 

Below is where you can find the latest releases of all the Selenium components. You can also find a 
Latest Releases list of previous releases, source code, and additional information for Maven users (Maven is a popular 

Java build tool). 


Selenium Downloads 


Previous Releases 

Source Code Selenium IDE 

Selenium IDE is a Firefox plugin which records and plays back user interactions with the browser. Use 
this to either create simple scripts or assist in exploratory testing. It can also export Remote Control 


or WebDriver scripts, though they tend to be somewhat brittle and should be overhauled into some 
sort of Page Object-y structure for any kind of resiliency. 


Maven Information 


Donate to Selenium 
Download latest released version 2.5.0 released on 01/Jan/2014 or view the Release Notes and then 


with PayPal install some plugins. 


Donate 
Selenium Server (formerly the Selenium RC Server) 


¡[SAT : : 

ha The Selenium Server is needed in order to run either Selenium RC style scripts or Remote Selenium 
through sponsorship Webdriver ones. The 2,x server is a drop-in replacement for the old Selenium RC server and is 
You can sponsor the Selenitum designed to be backwards compatible with your existing infrastructure, 


project if you'd BRE Some pablo Download version 2.42.2 
recognition of your generous 


contribution, To use the Selenium Server in a Grid configuration see the wiki page 


Step 2: After downloading, we need to start the Selenium Server. To do so, 
open command prompt and navigate to the folder where the downloaded JAR file 
is kept as shown below. 


edenium-serve-sttandalone-242 2 j0 


| BECA WedoritsystemiZic idas 


ENSOMAL 


. DOCt 


A E 


Step 3: To start the server, use the command 'java -jar <<downloaded jar 
name >> and if java JDK is installed properly, you would get a success message 
as shown below. Now we can start writing Selenium RC scripts. 
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CaWindowsisystem321cmd.exe - java -jar selenium-server-standalone-2,42.2.jar l-=-]| 


D:v>cd DIMPERSONAL DOCSy3Selenium TrialsxJAR 
D:XPERSONAL DOCSASelenium TrialsxJAR>java —jar selenium-server-standalone-2.42.2.jar 


z Launching a standalone server 
— Java: Oracle Corporation 25.11-h03 
— 08: Windows 7? 6.1 amd64 
-— 42.42.2, with Core v2.42.2. Built from revision 6a6995d 
— RemotelebDriver instances should connect to: http://127.B.0.1:4444/wd/hub 
— Version Jetty/5.1.x 
— Started HttpContext[/selenium-server,/selenium-server] 


Started org.openga.jetty.jetty.serulet.SeruletHandlerfP35851384 
Started HttpContextL/wd,/wdl 
e ate a Sn ZIRE ¿Qium-server/driver] 


] 
SocketListener on 0.0.0.0:4444 
Started org.openga.jetty.jetty.Serverf3Mdae8i 


Configure Selenium WebDriver 


PE 


Now let us look at how to configure Selenium WebDriver. We will understand 
how to develop scripts with Selenium WebDriver in later chapters, however for 


now, we will understand just the configuration part of it. 


Step 1 : Navigate to the selenium downloads section 


http://www .seleniumhq.org/download/ and download Selenium WebDriver by 


clicking on its version number as shown below. 


The Internet Explorer Driver Server 


This is required if you want to make use of the latest and greatest features of the WebDriver 
InternetExplorerDriver. Please make sure that this is available on your SPATH (or %PATH% on 
Windows) in order for the IE Driver to work as expected. 


Download version 2.42.0 for (recommended) 32 bit Windows IE or 64 bit Windows IE 
CHANGELOG 


Selenium Client 8 WebDriver Language Bindings 
In order to create scripts that interact with the Selenium Server (Selenium RC, Selenium Remote 


Webdriver) or create local Selenium WebDriver script you need to make use of language- specific client 


drivers. These languages include both 1,x and 2.x style clients. 


While language bindings for other languages exist, these are the core ones that are supported by the 
main project hosted on google code. 


Language Client Version Release Date 
2014-06-03 Download Change log Javadoc 
42. ( 15-2 Download Change log 
Ruby 2.42.0 2014-05-22 Download Change log 
Python 2.42.1 2014-05-27 Download Change log 
Javascript (Node) 2.42.0 2014-05-22 Download Change log 
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Step 2: The downloaded file is in Zipped format and one has to unzip the 
contents to map it to the project folder. 


» Computer » DataDisk(D:) » PERSONAL DOCS » Selenium Trials » JAR » 


ev Include in library y Share with w New folder 


2 


Name Date modified Type 


us selenium-java-2,42,2 27/07/20148:18 AM File folder 


== selenium-java-2,42,2,zip 27/07/2014 8:17 AM WinRAR ZIP archive 24,140 KB 


Step 3 : The Unzipped contents would be displayed as shown below. How to 
map it to the project folder and how to start scripting would be dealt in the 
WebDriver chapter. 


<« PERSONAL DOCS » Selenium Trials » JAR » selenium-java-2.42.2 » selenium-2.42,2 » 


v Include in library y Share with New folder 


2 


Name Date modified Type 
libs 3/06/2014 10:42 AM  Filefolder 
| | CHANGELOG 3/06/2014 10:42 AM File 65 KB 


a] selenium-java-2,42,2,jar 3/06/2014 10:42 AM  Executable Jar File 3,708 KB 


a) selenium-java-2,42,2-srcs.jar 3/06/2014 10:42 AM Executable Jar File 628 KB 
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What is Selenium RC? 


Selenium Remote Control (RC) was the main Selenium project that sustained 
for a long time before Selenium WebDriver (Selenium 2.0) came into existence. 
Now Selenium RC is hardly in use, as WebDriver offers more powerful features, 
however users can still continue to develop scripts using RC. 


It allows us to write automated web application Ul tests with the help of full 
power of programming languages such as Java, C+, Perl, Python, and PHP to 
create more complex tests such as reading and writing files, querying a 
database, and emailing test results. 


Selenium RC Architecture 


Selenium RC works in such a way that the client libraries can communicate with 
the Selenium RC Server passing each Selenium command for execution. Then 
the server passes the Selenium command to the browser using Selenium-Core 
JavaScript commanads. 


The browser executes the Selenium command using its JavaScript interpreter. 
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e 8 
Application Application Application 
Under Test Under Test Under Test 


Selenium Remote 
Control Server 


Java, CHt, Ruby, 
Python or Php 


Selenium RC comes in two parts. 


e. The Selenium Server launches and kills browsers. In addition to that, it 
interprets and executes the Selenese commands. It also acts as an HTTP 
proxy by intercepting and verifying HTTP messages passed between the 
browser and the application under test. 


e Client libraries that provide an interface between each one of the 
programming languages (Java, C+, Perl, Python, and PHP) and the 
Selenium-RC Server. 


RC - Scripting 


Now let us write a sample script using Selenium Remote Control. Let us use 
http://www.calculator.net/ for understanding Selenium RC. We will perform a 
Percent calculation using 'Percent Calculator' that is present under the 'Math 
Calculators' module. 


Step 1 : Start Selenium Remote Control (with the help of command prompt). 


Step 2 : After launching Selenium RC, open Eclipse and create a "New Project" 
as shown below. 
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Interface 

Enum 
Annotaton 
Source Folder 
Java Working Set 


540005 


Tutorials 
Rentene 2 ' Go through tutortate 


Lá 


Hetresh 
Convert Line Detimiter To 
What's New 


Fnd out what a nuw 


Pera 


Saatch Worespece 


Create a Java Project 


Create a Java project in the workspace or in an external location. 


Y 
Project name: selrcdemo 
», a 


/| Use default location 


Location; | DAPERSONAL DOC5iSelenium Trialsiselrcdemo 


JRE 


(0) Use an execution environment JRE: [lavaSE-L8 


(5) Use a project specific JRE: |jre8 
(O) Use default JRE (currently 'jre8') Configure JREs... 


Project layout 
(0) Use project folder as root for sources and class files 


(0) Create separate folders for sources and class files Configure default... 


Working sets 


[7] Add project to working sets 


Working sets: 
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Step 4: Verify the Source, Projects, Libraries, and Output folder and click 
"Finish". 
< New Java Project 
Java Settings 
Define the Java build settings. 


5 Source [> Projects | Es) Libraries | 2 Order and Export 


| Ap 6 
hi? ne | : AY a Y 
b 
q _u.—eceeeemmo—Á 
a 5 selrcdemo' 
, EX src 


w Details 


(8 Create new source folder; use this if you want to add a new source folder to 
your project, 


¿a Link additional source: use this if you have a folder in the file system that 
should be used as additional source folder. 


(32 Add project 'selrcdemo' to build path: Add the project to the build path if the 
project is the root of packages and source files. Entries on the build path are 
visible to the combiler and used for buildina. 


[F] Allow output folders for source folders 
Default output folder: 


selrcdemobin PA 


no 
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Step 5 : Right click on 'project' container and choose 'Configure Build Path'. 


AS 


Eñe £án Gomece Meñecos Pegate Seguir Pryor fun Anto ep 


1 Package Explorer 


Ops in en Verd io 
Oper Tyzs Herertiy 


Share le 


Copy 
Copy Guiños Muere 

E Parte 

K Delete 


DEDO: 


- ' 


y impor. 
az Emper 


PODA 


Vebraata 


Chose Peje 
Armar Vésrtrg het 


r 


Dietas As 
Par, An 

Tes 

Comgare Wines 

Petare hom Local Hgter 


Conrbspaso 


Puente Ar Ena 


- A -0-A AAA. +. 


de LrkSeece 


Gare A 
Pabactor Alta Shah To 


o Urea Saw Fobde 
mm had Lasmal hachas. 


e Al iia 


(GD 


' 
y 
' 
' 


Be Cutie 


dan ogthre 15 9ct martatds 


Step 6 : Properties for 'selrcdemo' opens up. Navigate to 'Libraries' tab and 
select 'Add External JARs'. Choose the Selenium RC jar file that we have 
downloaded and it would appear as shown below. 


3 Properties for selrcdemo 
type filter text 


» Resource 


Java Build Path 


Builders 


Java Build Path 


| a Source | L> Projects | E Libraries 


> Java Code Style 

> Java Compiler 

> Java Editor 
Javadoc Location 
Project References 
Run/Debug Settings 


E] Source attachment: (None) 

1) Javadoc location: (None) 

E Native library location: (None) 

¿Ss Access rules; (No restrictions) 
RE System Library [Javast-1.8 


Add Variable... 


Add Library... 


Add Class Folder... 


Add External Class Folder... 


Edit. 


Remove 


Migrate JAR File 
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Step 7 : The referenced Libraries are shown as displayed below. 


file Ebt Source Refscior Hempgrte Segrch Project fun Ynduw  p 
o. 6-0-4-». ¿4G> 


1 Pactage Explorer 
e“ relhicdemo 
Det 
a Bd JE System Libaary 
lus PESOUICESIM 
pe jar 
prue jar 
¡cejar 
charsets jar 
> Jl jas 
“ accenm-brndge A jar 
« cididata jar 
A 
patcess jar 
Part as 
tocaledara jor 
« mashom jar 
4 DUNEC. jar 
+ vunjos provider jar 
APT Api gar 
sorpkcll jar 


4 selenium-server-standalone-243.2 jer 


Selenium 


Step 8 : Create a new class file by performing a right click on 'src' folder and 


select 'New' >> 'class', 


3 Java - Eclipse 


File Edit Source Refactor Navigate Search Project Run Window Help 


mo ES DMA DENT ACA AS 


HE Package Explorer 5 
a [2 selrcdemo 
(3 src 


” 


a LIA 

A 
> Y =. 
il Open in New Window (3 


Open Type Hierarchy Fa a 


Show In Alt+ShifteW 


Copy Ctrl+C ed 
Copy Qualified Name 6 
Paste cmev € 
Delete Delete eS 


pa 


Build Path » 
Source Alt+Shift+S » 
Refactor Alt+Shift+T » 


Import... 
Export... 


Refresh 

Assign Working Sets... 
Debug As 

Run As 

Team 

Compare With 

Restore from Local History... 


Properties Alt+Enter 
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Java Project 
Project... 


Package 


Interface 

Enum 
Annotation 
Source Folder 
Java Working Set 
Folder 

File 

Untitled Text File 
JUnit Test Case 


Other... 
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Step 9 : Enter a name of the class file and enable 'public static void main' as 
shown below. 


O New Java Class Co (063 


Java Class 


¿1, Type name is discouraged. By convention, Java type names usually start with an Y 
uppercase letter 


Source folder: selrcdemof/sre 


Package: selrcdemo Browse... 


[] Enclosing type: Browse. 


Name: redemo 


Modifiers: a >) package private protected 
PJ abstract [| |final static 


Superclass: java.lang.Object 


Interfaces: 


Which method stubs would you like to create? 
[Y] public static void main(String[] args) 


Constructors from superclass 


[Y] Inherited abstract methods 


Do you want to add comments? (Configure templates and default value here) 


A] Generate comments 


Step 10 : The Created Class is created under the folder structure as shown 
below. 


E] 


E Package Explorer ¿23 


a (2 selrcdemo 
a (2 src 


> E Referenced Libraries 
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Step 11: Now it ¡is time for coding. The following code has comments 
embedded in it to make the readers understand what has been put forth. 


package selrcdemo; 


import com.thoughtworks.selenium.DefaultSelenium; 


import com.thoughtworks.selenium.Selenium; 


public class rcdemo 


( 


public static void main(String[] args) throws InterruptedException 


( 


// Instatiate the RC Server 

Selenium selenium = new DefaultSelenium("localhost", 4444, 
"firefox", "http://www.calculator.net"); 

selenium.start(); // Start 
selenium.open("/"); // Open the URL 


selenium.windowMaximize(); 


// Click on Link Math Calculator 
selenium.click("xpath=.//*[(fMid='menu']/div[3]/a"); 
Thread.sleep(2500) ; // Wait for page load 


// Click on Link Percent Calculator 
selenium.click("xpath=.//*[Mid='menu']/div[4]/div[3]/a"); 
Thread.sleep(4000) ; // Wait for page load 


// Focus on text Box 


selenium.focus("name=cpar1"); 


// enter a value in Text box 1 


selenium.type("css=input[name=Y"cpar11"]", "10"); 
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// enter a value in Text box 2 
selenium.focus("name=cpar2"); 


selenium.type("css=input[name=1Y"cpar2X"]", "50"); 


// Click Calculate button 
selenium.click("xpath=.//*[id='content']/table/tbody/tr/td[2]/input"); 


// verify if the result is 5 
String result = selenium.getText(".//*[(Mid='content']/p[2]"); 


if (result == "5") 
1 

System.out.printin("Pass"); 
jelse 
1 

System.out.printin("Fail"); 
J 
J 


Step 11 : Now, let us execute the script by clicking the 'Run' Button. 


SS Java - selrcdemo/stc/selrcdemo/rcdemo,java - Eclipse 


File Edit Source Refactor Mavigate Search Project Run Window Help 


al 


(Y) tutorialspoint 


Selenium 


Step 12 : The script would start executing and the user would be able to see 
the command history under the 'Command History" Tab. 


y Selenium Remote Control v2,42.2 Le la 


» 'D chrome://src/content/RemoteRunner.html?session!d=a0d9fd20d4d34cf88df60e1888962e2e8lmultiWindow=trueg8 > E |El - Google 


Selenium Functional Testing for Web Apps Command History: 


Open Source From ThoughtWorks and Friends click(xpatn=.//*[fid="menu']/div[3]/a) 
click(xpath=.//*[fid="menu']/div([4]/div[3]/a) 
= focus (name=cpar1) 

Show Log [E] slow Mode type (css=input [name="cpar1"], 10) 
focus (name=cpar2) 
a0d9fd20d4d34cf88df60e1888962e2e  [tvpeless=input [name="cpar2"], 50) 
click(xpath=.//*[fid='content']/table/tbody/tr/td[2]/input) 
getText (.//*[fid='"content']/p[2]) 


Step 13 : The final state of the application is shown as below. The percentage is 
calculated and it displays the result on the screen as shown below. 


3 Percert Calculator 

€ ñú calculator net 

Calc 
¿IC 


ulator.net 


» Financial Caiculatore 


Percent Calculator 
» Welght Loss Calcularors Free 


Please Ml arvy to Selds in the lobowwng percentage calculator and áck Me "Calciudate” butión to get 


me Puro value Calculator 


Y Mah Calcularors 


¡Result 


» Percent Calculalor Free 


Free 
Calendar 


in mathermalica a percentage 13 a number in he ración ef 100 Tis often denoted wii le symbol 
Pr . ; otr ocsima “per ar "percent For ssample, 35 5 equiientto 0.35 01 358/100. The calculato 
o ( 

regaancy Colculator above can take amy two values and calas se ihird value Example 
» Otivar Cabculators 5 percent ol Y =? 


a 1d Free 
» Calculators hor Yawr Si 5 percent of? =15 
£ pr hor Ya Sin Spell Checker 


Step 14 : The output of the test is printed on the Eclipse console as shown 
below, as we have printed the output to the console. In real time, the output is 
written to an HTML file or in a simple Text file. 


£ Problema (5 Jevedos  Derietation E) Console 
«dermmnated> rodermo Java Appbeation] CAProgram File Java jreB bin jac ar (29 1d 2014 12:00:44 an) 


Pass 
y 
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5. SELENESE COMMANDS 


A command refers to what Selenium has to do and the commands in Selenium 
are of three types: 


e Actions 
e Accessors 


e Assertions 


Actions 


Actions are commands that manipulate the state of the application. Upon 
execution, if an action fails, the execution of the current test is stopped. For 
example, "click a link" and "select an option”. 


The following table lists the Selenium action commands that are used very 
frequently, however the list is note exhaustive. 


Command/Syntax Description 


click (locator) Clicks on a link, button, 
checkbox or radio button 


clickAt (locator, coordString) Clicks on an element with 
the help of locator and co- 
ordinates 

close () Simulates the user clicking 


the "close" button in the title 
bar of a popup window or 
tab. 


contextMenuAt (locator, coordString) Simulates opening the 
context menu of the 
specified element from a 
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doubleClick (locator) 


dragAndDrop (locator, movementsString) 


dragAndDropToObject (Dragobject, dropobject) 


Echo (message) 
fireEvent (locator,eventName) 


focus (locator) 


highlight (locator) 


mouseDown (locator) 
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specified location 


Double clicks on a 
webelement based on the 
specified element. 


Drags an element and then 
drops it based on specified 
distance. 


Drags an element and drops 
it on another element. 


Prints the specified message 
on console which is used for 
debugging. 


Explicitly simulate an event, 
to trigger the corresponding 
"onevent" handler 


Move the focus to the 
specified element 


Changes the background 
color of the specified 
element to yellow which is 
useful for debugging 
purposes. 


Simulates a user pressing 
the left mouse button on the 
specified element. 
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mouseDownAt (locator, coordString) 


mouseuUp (locator) 


mouseUpAt (locator, coordString) 


open (url) 


openWindow (url, windowID) 


pause (waitTime) 
refresh() 


select (selectLocator, optionLocator) 
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Simulates a user pressing 
the left mouse button at the 
specified location on the 
specified element. 


Simulates the event that 
occurs when the user 
releases the mouse button 


Simulates the event that 
occurs when the user 
releases the mouse button 
at the specified location. 


Opens a URL in the specified 
browser and it accepts both 
relative and absolute URLs. 


Opens a popup window. 
After opening the window, 
user need to activate it 
using the selectWindow 
command. 


Waits for the specified 
amount of time (in 
milliseconds) 


Simulates the user clicking 
the "Refresh" button on their 
browser. 


Select an option from a 
drop-down using an option 


56 


Selenium 


locator. 


selectWindow (windowID) Selects a popup window 
using a window locator; 
once a popup window has 
been selected, all focus 
shifts to that window. 


store (expression, variableName) The name of a variable in 
which the result is to be 
stored and expression is the 
value to store. 


type (locator, value) Sets the value of an input 
field, similar to user typing 
action. 

typeKeys (locator, value) Simulates keystroke events 


on the specified element, as 
though you typed the value 
key-by-key. 


waitForCondition (script, timeout) Executes the specified 
JavaScript snippet 
repeatedly until it evaluates 


to "true". 
waitForPageToLoad (timeout) Waits for a new page to 
load. 
waitForPopUp (windowlID, timeout) Waits for a popup window to 


appear and load. 


windowFocus() Gives focus to the currently 
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selected window 


windowMaximize() Resize the currently selected 
window to take up the entire 
screen 
Accessors 


Accessors evaluate the state of the application and store the results in a variable 


which is used in assertions. For example, "storeTitle". 


The following table lists the Selenium accessors that are used very frequently, 


however the list is not exhaustive. 


Command/Syntax 


assertErrorOnNext (message) 


storeAllButtons (variableName) 
storeAllFields (variableName) 
storeAllLinks (variableName) 


storeAllWindowlds (variableName) 
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Description 


Pings Selenium to expect 
an error on the next 
command execution with 
an expected message. 


Returns the IDs of all 
buttons on the page. 


Returns the IDs of all 
input fields on the page. 


Returns the IDs of all links 
on the page. 


Returns the IDs of all 
windows that the browser 
knows about in an array. 
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storeAllWindowTitles (variableName) 


storeAllWindowNames (variableName) 


storeAttribute (attributeLocator, variableName) 


storeBodyText (variableName) 


storeConfirmation (variableName) 


storeElementIndex (locator, variableName) 


storeLocation (variableName) 


storeSelectedIds (selectLocator, variableName) 
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Returns the names of all 
windows that the browser 
knows about in an array. 


Returns the titles of all 
windows that the browser 
knows about in an array. 


Gets the value of an 
element attribute. The 
value of the attribute may 
differ across browsers. 


Gets the entire text of the 
page. 


Retrieves the message of 
a JavaScript confirmation 
dialog generated during 
the previous action. 


Get the relative index of 
an element to its parent 
(starting from 0). 


Gets the absolute URL of 
the current page. 


Gets all element IDs for 
selected options in the 
specified select or multi- 
select element. 
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storeSelectedIndex (selectLocator, variableName) 


storeSelectedLabel (selectLocator, variableName) 


storeSelectedValue (selectLocator, variableName) 


storeSelectOptions (selectLocator, variableName) 


storeTable (tableCellAddress, variableName) 


storeText (locator, variableName) 


storeTitle (variableName) 


storeValue (locator, variableName) 
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Gets index (option 
number, starting at 0) for 
selected option in the 
specified select element. 


Gets label (visible text) 
for selected option in the 
specified select element.. 


Gets value (value 
attribute) for selected 
option in the specified 
select element. 


Gets all labels in the 
specified select drop- 
down. 


Gets the text from a cell 
of a table. The cellAddress 
syntax: 
tableLocator.row.column, 
where row and column 
start at 0. 


Gets the text of an 
element. This works for 
any element that contains 
text. 


Gets the title of the 
current page. 


Gets the (whitespace- 
trimmed) value of an 
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storeChecked (locator, variableName) 


storeElementPresent (locator, variableName) 


storeTextPresent (pattern, variableName) 


storeVisible (locator, variableName) 


Assertions 


Selenium 


input field. 


Gets whether a toggle- 
button (checkbox/radio) is 
checked. 


Verifies that the specified 
element is somewhere on 
the page. 


Verifies that the specified 
text pattern appears 
somewhere on the 
rendered page shown to 
the user. 


Determines if the 
specified element is 
visible. 


Assertions enable us to verify the state of an application and compares against 
the expected. It is used in 3 modes, viz. - "assert", "verify", and "waitfor". For 
example, "verify if an item from the dropdown is selected". 


The following table lists the Selenium assertions that are used very frequently, 


however the list is not exhaustive. 


Command/Syntax 


waitForErrorOnNext (message) 
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Description 


Waits for error; used with 
the accessor 
assertErrorOnNext. 
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verifySelected (selectLocator, optionLocator) Verifies that the selected 
option of a drop-down 
satisfies the 
optionSpecifier. 


waitForSelected (selectLocator, optionLocator) Waits for getting the 
option selected; used with 
the accessor 
assertSelected. 


waitForNotSelected (selectLocator, optionLocator) Waits for not getting the 
option selected; used with 
the accessor 
assertSelected. 


verifyAlert (pattern) Verifies the alert text; 
used with the accessor 
storeAlert. 


waitForAlert (pattern) Waits for the alert; used 
with the accessor 
storeAlert. 


verifyAllButtons (pattern) Verifies the button; used 
with the accessor 
storeAllButtons. 


waitForAllButtons (pattern) Waits for the button to 
load; used with the 
accessor storeAllButtons. 


verifyAllLinks (pattern) Verifies all links; used with 
the accessor storeAllLinks. 
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waitForAllLinks (pattern) Waits for all links; used 
with the accessor 
storeAllLinks. 


verifyAllWindowIds (pattern) Verifies the window id; 
used with the accessor 
storeAllWindowIds. 


waitForAllWindowlIds (pattern ) Waits the window id; used 
with the accessor 
storeAllWindowIds. 


verifyAttribute (attributeLocator, pattern) Verifies an attribute of an 
element; used with the 
accessor storeAttribute. 


waitForAttribute (attributeLocator, pattern) Waits for an attribute of an 
element; used with the 
accessor storeAttribute. 


verifyBody Text(pattern) Verifies the body text; 
used with the accessor 
storeBodyText. 


waitForBodyText(pattern) Waits for the body text; 
used with the accessor 
storeBodyText. 


waitForConfirmation(pattern) Waits for confirmation; 
used with the accessor 
storeConfirmationPresent 
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Locators 


Element Locators help Selenium to identify the HTML element the command 
refers to. All these locators can be identified with the help of FirePath and 
FireBug plugin of Mozilla. Please refer the Environment Setup chapter for details. 


identifier=id Select the element with the specified "id" attribute and 
if there is no match, select the first element whose Oname attribute is id. 


id=id Select the element with the specified "id" attribute. 


name=name Select the first element with the specified "name" 
attribute 


dom=javascriptExpression Selenium finds an element by evaluating 
the specified string that allows us to traverse through the HTML Document 
Object Model using JavaScript. Users cannot return a value but can 
evaluate as an expression in the block. 


xpath=xpathExpression Locate an element using an  XPath 
expression. 
link=textPattern Select the link element (within anchor tags) 


which contains text matching the specified pattern. 


css=cssSelectorSyntax Select the element using css selector. 


64 


EY) tutorialspoint 


6. WEBDRIVER 


WebDriver is a tool for automating testing web applications. It is popularly 
known as Selenium 2.0. WebDriver uses a different underlying framework, while 
Selenium RC uses JavaScript Selenium-Core embedded within the browser which 
has got some limitations. WebDriver interacts directly with the browser without 
any intermediary, unlike Selenium RC that depends on a server. It is used in the 
following context: 


Multi-browser testing including improved functionality for browsers which 
is not well-supported by Selenium RC (Selenium 1.0). 


Handling multiple frames, multiple browser windows, popups, and alerts. 
Complex page navigation. 
Advanced user navigation such as drag-and-drop. 


AJAX-based Ul elements. 


Architecture 


WebDriver is best explained with a simple architecture diagram as shown below. 


Web Application 


) 


Selenium Web Driver 


Selenium Test 
(Java, Cf, Ruby, Python, Perl, 
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Selenium RC Vs WebDriver 


Selenium 


Selenium RC 


The architecture of Selenium RC is 
complicated, as the server needs to be 
up and running before starting a test. 


Selenium server acts as a middleman 
between the browser and Selenese 
commands. 


Selenium RC script execution is slower, 
since it uses a Javascript to interact with 
RC. 


Selenium RC cannot support headless 
execution, as it needs a real browser to 
work with. 


It's a simple and small API. 


Less object-oriented API. 


Cannot test mobile Applications. 


Scripting using WebDriver 


Selenium WebDriver 


WebDriver's architecture is simpler 
than Selenium RC, as it controls the 
browser from the OS level. 


WebDriver interacts directly with 
the browser and uses the browser's 
engine to control it. 


WebDriver is faster, as it interacts 
directly with the browser. 


WebDriver can support the headless 
execution. 


Complex and a bit large API as 
compared to RC. 


Purely object-oriented API. 


Can test iPhone/Android 
applications. 


Let us understand how to work with WebDriver. For demonstration, we would 
use http://www.calculator.net/. We will perform a "Percent Calculator" which is 
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located under "Math Calculator". We have already downloaded the required 
WebDriver JAR's. Refer the chapter "Environmental Setup" for details. 


Step 1 : Launch "Eclipse" from the Extracted Eclipse folder. 


LJ oe de 0 Detail (Dil > PERSONAL DOCS » Echpse » eclipse-standard-kma-R-mini2-196.64 > eclipse » 


Organue += Inctude wm library + Hare urth Mew tobder 


corfigurabon 
dupra 
features 

7 

prugins 


resódme 


ecipseproduct 


| 


PR” echpuec exe 
2" epl-v10. tm 


E ruticehtmi 


Step 2 : Select the Workspace by clicking the 'Browse' button. 
3 Workspace Launcher 


Select a workspace 


Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


NAOMI: PERSONAL DOCSSeleniurm Trials v Browse... 


[7] Use this as the default and do not ask again 
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Step 3 : Now create a 'New Project' from 'File' menu. 


Vackoge 

Class 

Interface 

Enum 

Annotaton 

Source Folder 

lava Working Set 

Folder Tutorials 

Fla Go through tutortate 


Betresh 


Untiled Text File 
Convert Line Delimiter To + Juvit Test Case 


What's New 
Find out what a nuw 


Other 
Sertch Worepece 


|< New Java Project 


Create a Java Project 


Create a Java project in the workspace or in an external location. 


Use default location 


| DAPERSONAL DOCS Selenium TrialsWebDriverDemo. 


JRE 


(0) Use an execution environment JRE; | JayaSE-1,8 


(O) Use a project specific JRE: | jre8 


O Use default JRE (currently 'jre8') Configure JREs... 


Project layout 


O) Use project folder as root for sources and class files 


/0) Create separate folders for sources and class files Configure default... 


Working sets 
[7] Add project to working sets 


68 


tutorialspoint 


SIMPLYEASYLEARNING 


Selenium 


Step 5 : Go to Libraries Tab and select all the JAR's that we have downloaded. 
Add reference to all the JAR's of Selenium WebDriver Library folder and also 
selenium-java-2.42.2.jar and selenium-java-2.42.2-srcs.jar. 


SS New Java Project lo Los 
Java Settings 
Define the Java build settings. 


| (4 Source | L> Projects | EM Libraries |“. Order and Export 


JARs and class folders on the build path: 


apache-mimedj-0.6.jar - DAPERSONAL DOCSSelenium” « Add JARs.., 


bsh-1.3.0.jar - DMPERSONAL DOCS Selenium TrialsWJARI 


cglib-nodep-2.1 3.jar - DAPERSONAL DOCS Selenium Tr Add External JARs... 
commons-codec-1.9.jar - D:PERSONAL DOCS¡Seleniurr! z 

s ; Add Variable... 
commons-collections-3.2.1.jar - DAPERSONAL DOCS¡Se 


commons-exec-1,1,jar - DAPERSONAL DOCS¡Selenium 1 Add Library... 


commons-io-2.4.jar - DAPERSONAL DOCS Selenium Triz 


commons-jxpath-1.3.jar - DAPERSONAL DOCSiSeleniurr || | Add Class Folder... 
CNN DAPERSONAL DOCSiSeleniur Add External Class Folder... 
commons-logging-1.1,3.jar - DMPERSONAL DOCS¡Selen 

cssparser-0,9.11.jar - DAPERSONAL DOCSSelenium Trial! 
guava-15.0.jar - DPERSONAL DOCSSelenium Trials JAR 
hamcrest-core-1.3.jar - DAPERSONAL DOCSiSelenium Ti — 
hamcrest-library-1.3,jar - DAPERSONAL DOCS Selenium 
htmlunit-2.14,jar - DYPERSONAL DOCS¡Selenium Trials, 
htmlunit-core-js-2.14.jar - DAPERSONAL DOCS 'Seleniun 
httpclient-4.3.2.jar - DAPERSONAL DOCS¡Selenium Trials 
httpcore-4,3.1,jar - DAPERSONAL DOCSSelenium Trials! 
httpmime-4,3.2.jar - DUPERSONAL DOCS Selenium Trial 
ini4j-0,5,2,jar - DAPERSONAL DOCS Selenium Trials JAR' 
j¡commander-1.29.jar - DPERSONAL DOCS¡Selenium Tr 
jetty-websocket-8.1,8.jar - DAPERSONAL DOCSSeleniun 


E nan BN BERONAL O Abc TrialJARis Y 
4 mm » 


Edit... 


Migrate JAR File... 


Nets | Finish Cancel 
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Step 6 : The Package is created as shown below. 


FE Package Explorer ¿2 


» (2 selrcdemo 


y" [45 WebDriverDemo! 


EB src 


E JRE System Library [JavaSE-1.8] 
Ex, Referenced Libraries 


Selenium 


Step 7 : Now right-click on the package and select 'New' >> 'Class' to create a 


'Class'. 


HE Package Explorer 23 
» (2 selrcdemo 
a (7 Webhe 


Go Into 


Open in New Window 
Open Type Hierarchy 


Show In 


Copy 

Copy Qualified Name 
Paste 

Delete 


Build Path 
Source 
Refactor 


Import... 
Export... 

¿> Refresh 
Close Project 


Close Unrelated Projects 


Assign Working Sets... 


Debug As 
Run As 
Team 


Compare With 


Restore from Local History... 


Configure 


Properties 
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: 


Alt+Shift+W » ' 


Ctrl+C 


¡e 
o 


| 
» 


5 
Delete P 


Alt+ShifteS » | => 


Alt+Shift+T » | 


| 
pl 


Alt+Enter 


ES 


7 


ZW 


Java Project 


Interface 


¡6 Enum 


Annotation 
Source Folder 
Java Working Set 
Folder 

File 

Untitled Text File 
JUnit Test Case 


Other... 


Ctrl+NM 
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Step 8 : Now name the class and make it the main function. 


O New Java Class 


Java Class 


1, The use of the default package is discouraged. 


Source folder: ¡ WebDriverDemof/src 
Package: (default) 


[F] Enclosing type: | | Browse 


Name: webdriverdemo 
Modifiers; (9) public O) package private protected 
[Pl abstract [final Fl] static 


Superclass: java.lang.Object 


Browse... 


[Y] Inherited abstract methods 
Do you want to add comments? (Configure templates and default value here) 
[5] Generate comments 


pu 


(ETT) TE 
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Step 9 : The class outline is shown as below. 


HE Package Explorer 23 ES y a] [3] webdriverdemo,java % 


(2 selrcdemo 1 
a (2) WebDriverDemo 2 public class webdriverdemo £ 


as (LB src 
a EB (default package) 
[5] webdriverdemo.java 
E, JRE System Library [lavaSE-1.8 
2, Referenced Libraries 


public static void main(Stringl] ia: y 


Auto-generated meth 


Step 10 : Now it is time to code. The following script is easier to understand, as 
it has comments embedded in it to explain the steps clearly. Please take a look 
at the chapter "Locators” to understand how to capture object properties. 


import java.util.concurrent.Timeunit; 
import org.opengqa.selenium.*; 


import org.opengqa.selenium.firefox.FirefoxDriver; 


public class webdriverdemo 


( 


public static void main(String[] args) 


ñ 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 10 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 


driver.navigate().to("http://www.calculator.net/"); 


// Maximize the browser 


driver.manage().window().maximize(); 


// Click on Math Calculators 
driver.findElement(By.xpath(".//*[Mid='menu']/div[3]/a")).click(); 


72 


LEARNING 


EH tutorialspoint 


Selenium 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(Mid='"menu']/div[4]/div[3]/a")).click(); 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver .findElement(By.xpath(".//*[(Mid='content']/table/tbody 
/tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 
String result = 


driver.findElement(By.xpath(".//*[Mid='content']/p[2]/span/font/b">) 


) 
.getText(); 
//Print a Log In message to the screen 
System.out.println(" The Result is " + result); 
//Close the Browser. 
driver.close(); 

J 
J 


Step 11 : The output of the above script would be printed in Console. 
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The following table lists some of the most frequently used commands in 


WebDriver along with their syntax. 


Command 


driver.get("URL”)>) 


element.sendKeys("inputtext") 


element.clear() 


select.deselectAll() 


select.selectByVisibleText("some text") 


driver.switchTo().window("windowName”) 


driver.switchTo().frame("frameName"”) 


driver.switchTo().alert() 


driver.navigate().to("URL") 


 tutorialspoint 


Description 


To navigate to an application. 


Enter some text into an input box. 


Clear the contents from the input 
box. 


Deselect all OPTIONs from the first 
SELECT on the page. 


Select the OPTION with the input 
specified by the user. 


Move the focus from one window 
to another. 


Swing from frame to frame. 


Helps in handling alerts. 


Navigate to the URL. 
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driver.navigate().forward() To navigate forward. 
driver.navigate().back() To navigate back. 
driver.close() Closes the current browser 


associated with the driver. 


driver.quit() Quits the driver and closes all the 
associated window of that driver. 


driver. refresh() Refreshes the current page. 
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Locating elements in Selenium WebDriver is performed with the help of 
findElement() and findElements() methods provided by WebDriver and 
WebElement class. 


e findElement() returns a WebElement object based on a specified search 
criteria or ends up throwing an exception if it does not find any element 
matching the search criteria. 


e findElements() returns a list of WebElements matching the search criteria. 
If no elements are found, it returns an empty list. 


The following table lists all the Java syntax for locating elements in Selenium 
WebDriver. 


Method Syntax Description 


By ID driver.findElement(By.id(<element ID>)) Locates an 
element 
using the ID 
attribute 


By driver.findElement(By.name(<element name>)) Locates an 

name element 
using the 
Name 
attribute 


By class driver.findElement(By.className(<element class>))  Locates an 

name element 
using the 
Class 
attribute 


By tag driver.findElement(By.tagName(<htmltagname>)) Locates an 
name element 
using the 
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By link driver.findElement(By.linkText(<linktext>)) 
text 


By driver.findElement(By. partialLinkText(<linktext>)) 
partial 
link text 


By CSS  driver.findElement(By.cssSelector(<css selector>)) 


Selenium 


HTML tag 


Locates a 
link using 
link text 


Locates a 
link using the 
link's partial 
text 


Locates an 
element 
using the 
CSS selector 


By driver.findElement(By.xpath(<xpath>)) Locates an 
XPath element 
using XPath 
query 
Locators Usage 


Now let us understand the practical usage of each of the locator methods with 


the help of http://www,.calculator.net 


By ID 


Here an object is accessed with the help of IDs. In this case, it is the ID of the 
text box. Values are entered into the text box using the sendkeys method with 


the help of ID(cdensity). 


(Y) tutorialspoin 
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>) [EL Mass Calculator 
ES Mm a calculator 1 aber 
% Most Visited | Getting Started | Suggested Sres | Web Slice Gallery New Tab 


Calculator.net 


Hora / Math Carcutators / Mass Caicolator 


» Financial Caícul 
inancial Calculators Mass Calculator 


» Weight Loss Calculator 
ld Thús (9 a basic mass calculator based on density and volume. Thes calculator 
results of mary common unks 


'* Math Calculators 
> Eciomic Calcutañor 
Fraction Calculator 
Pescar Caloutatos 


1 cubic melet 


Time Calculator 


Triangle Cabcutator Calculate $ 


> 
> Volume Calcutañor 
, 


Humobor Sequence Calculator 
» Pregnancy Calculators 
» Other Calculators 


» Calculators for Your Site 


e UL >) 2 Comte HIML => 055 Soípt DOM Met 
ó Edit  imputfcdensity * td * tr + tbody * tablessiandard panel divecontunt 


= “LADA Lan "itandala" 214862 párol 


td + tr < tbody * table + body < Html 


3 <ubody> 
A erzr 
«md aligue "right" 
Si <rd align=*right">» 
“np 10""2tensity” =yper tesi? siyier”"orar-allgn 
right" relue="1902* sigo=*k” naso="cámnaisy"* 
</5ó> 
ii <rd> 
li <select 1dr”"codensityunit” niper”odensityunit”"> 


£/14> 


driver.findElement(By.id("cdensity")).sendKeys("10"); 
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By Name 


Selenium 


Here an object is accessed with the help of names. In this case, it is the name of 
the text box. Values are entered into the text box using the sendkeys method 


with the help of ID(cdensity). 


7 Men Calculator 
eb a esiculatos ret 


2 Most Vivtes Getting Marted Sugpested Ses Web ce Gallery Ne Tato 


Calculator.net 


Met Calclaea / Mars Coicida! 


»¡ il Cabculatos A 
Si it Mass Calculator 
» Weight Loss Culcutators 


rosadta of mans common unite 
Y Math Colcuiatora EL En 


Thés 16 a task mass calodañor basos on denaty and volume This calcdasor takes and generadas 


> Sgaurite Cabeutatos o Modify the values and click tho button to uso 


> Frachon Calertatos pp 
> Percent Calculator co) lilograsm/cubk metes - 
»T Calcuatar volume 1 cubie meter - 
> Titangta Calristator Cóculale Y 
, 
> Mumte! Eequenz 

» Prognancy Caleutators 


» Omor Calculator: 


» Calcutators loe Your Sito 


EC) Gomar HIM? (5S Sot DOM Het sde  FePath 


a Edi inputkedanety + td + te + body + tableszandaidagarn! * tonm + diecortent * 4 Y + tbody + table - body + html 
S TTRULO LAR ITALAL EA” ULA O pAÑE LS 
3 «body» 


canpar 1de”"udansiny” viper "iaa? exqior? si-eliga: 
sgh? selare“t900* ri10no*o” sane” inimnrtóyo 


Style > Computed 


*-— alesant style 
text-align: =1 


y Inmberited teom == 


p, 08, dir, ep 


driver.findElement(By.name("cdensity")).sendKeys("10"); 
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By Class Name 


Here an object is accessed with the help of Class Names. In this case, it is the 
Class name of the WebElement. The Value can be accessed with the help of the 
gettext method. 


Calculator.net 


€) —Mosity tire snbuea and clich the 


List<WebElement> byclass = driver.findElements(By.className("smalltext 
smtb")>); 


By Tag Name 


The DOM Tag Name of an element can be used to locate that particular element 
in the WebDriver. It is very easy to handle tables with the help of this method. 
Take a look at the following code. 


WebElement table = driver.findElement(By.id("calctable")); 
List<WebElement> row = table.findElements(By.tagName("tr")); 


int rowcount = row.size(); 
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By Link Text 
This method helps to locate a link element with matching visible text. 


Hall Lite Calculator ue 


4 dodo. 


UE) Most Vivted | Getting Started... Suggested Sites | Web ice Gallery. New Tab 


Calculator.net 


qua ) bigto Eadatabara Y phd pas 


pr Half Life Calculator 


The follweng tots can generate any pone ol Me rates hom he other Pere in bs halle formida d 
asutatance undergolng decay to decrease by 


» Weight Loss Calculatora 
Y Marth Calculatora 


Ivantic Calculador Half Life Calculator 


Frachor Calcud ato Piaago pros amy Mires ot mo foliar 10 calcuista Pre Tour value 
Parcent Calculado 
quartity rersiena inibal cpuartity tir 

M 


' Mo 


DA Caio alo 


vo dume € 


> Mumber Saquence Blcut ati Calculate Y 


» Pregnanoy Cascaul 


a Half Life, Mean Lifetime, and Decay Constant Conversion 


» Colcubators toc Yo Please rounds anpone ol he lodoeang lo gel he other two 


hallate mean line Uecay consiwré 
; A 1 h 
' 


$2 Comeida HTML > 055 Script DOM Met Cochies —FireFath 


Owmb + dwmbom + divsmeny + dsleftt - td tbody * table - body * mmi 


* lane" 
classe "> 


Y «div claceo"r”*> 


<div> 
W <div clene*ro*> 
4/41 w> 

MH <div sm "> 

fi <al 


driver.findElements(By.linkText("Volume")).click(); 
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By Partial Link Text 
This method helps locate a link element with partial matching visible text. 


Hall Lie Calculator 


dolar net 


A Most Vruted Getbing Hare Suggested Sites Wet Hice Gallery New Tab 


Calculator.net 


» Financial Calculators * 
Half Life Calculator 
» Víaight Loss Calcutatora A 
The fol went us sy generate an pre 0 Me ratyel 
ly Mah Calculas asutatance undergolng decay to decrease ty hal 
Marh Calculatora 


Half Life Calculator 


m tires ot he tolera 10 calcuiats Pre Tour 


Piaago pro 


quart; terna imibal quartty 
a Mm 


Calculote $ 
» Pregnanoy Cascuialo: 


» Omer Calculator 


Half Life, Mean Lifetime, and Decay Constant Conversion 


» Colcutators tor Youl Si Please trurds ar e ol re lvdoeang to pel he other two 


hallate mean lirárme secas 
t 
r 


2 Cimacdo HTML + 055 
mo de mba > ds meny 


Ñe 
$ «div clas 


driver.findElements(By.partialLinkText("Volume")).click(); 


By CSS 


The CSS is used as a method to identify the webobject, however NOT all 
browsers support CSS identification. 


WebElement loginButton = 
driver.findElement(By.cssSelector("input.login")); 


By XPath 
XPath stands for XML path language. It is a query language for selecting nodes 
from an XML document. XPath is based on the tree representation of XML 
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documents and provides the ability to navigate around the tree by selecting 


nodes using a variety of criteria. 


E Halt Life Calcutaror 


ES a cabculator. net 


A Mor Mañed Getting Herted Suggerted See Web Shoe Gadery He Tab 


Calculator.net 


» Financial Calcutators 
» Weight Loss Calcuiators 


Y Math Coloculators 
, ectibe Crtalos 
3) Ficdion Cato! 
> Percom Caácisalor 
> Time Calcitaio 
3 Tiange Calcuialor 


> Volume Cabcultador 


> Hunmbe Saguence Cacutatos 


» Pregnancy Calculatore 
» Othor Calculatora 


» Calculator tor Yowt Sine 


YC) A Coal 
Top Window * Highlight 1 pan - 


ath Coscidrtara ( Hal Life Cascada 


Half Life Calculator 


The following toos car generate ay one of be ralues tom he other Pres in be hable formáa do 
a uban os unaergolng deca lo decrease bp hall 


Half Life Calculator 


Praase pruade any ree ola tol lo calcuiós Pre fourth vals 


guarsty remars mibial quart; 


Calculate $ 


Half Life, Mgán Lifetime, and Decay Constant Conversion 


Prease pruade afone el te totowing to pel he clter teo 


halt-tra mean terme — decay constará 
t 
t 4 


driver.findElement(By.xpath(".//*[(Mid='content']/table[1]/tbody/tr/td/ta 
ble/tbody/tr[2]/td[1]/input")).sendkeys("100"); 
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User Interactions 


Selenium WebDriver is the most frequently used tool among all the tools 
available in the Selenium tool set. Therefore it is important to understand how to 
use Selenium to interact with web apps. In this module, let us understand how 
to interact with GUI objects using Selenium WebDriver. 


We need to interact with the application using some basic actions or even some 
advanced user action by developing user-defined functions for which there are 
no predefined commands. 


Listed below are the different kinds of actions against those GUI objects: 
e Text Box Interaction 
e Radio Button Selection 
e Check Box Selection 
e Drop Down Item Selection 
e Synchronization 
e Drag 8: Drop 
e Keyboard Actions 
e Mouse Actions 
e Multi Select 
e Find All Links 


Text Box Interaction 


In this section, we will understand how to interact with text boxes. We can put 
values into a text box using the 'sendkeys' method. Similarly, we can also 
retrieve text from a text box using the getattribute("value") command. Take a 
look at the following example. 
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Home / Math Calculators / Percent Calculator 


Percent Calculator 


Please fill any two fields in the following percentage calculator and click the "Calculate” button to get 
the third value 


» Financial Calculators 


» Weight Loss Calculators 


y Math Calculators 


> Scientific Calculator “Calculate 6 
> Fraction Calculator 
» Percent Calculator 


> Time Calculator 

athematics, a percentage is a number in the fraction of 100. Itis often denoted with the symbol 
"%”, or simply “pct” or “percent”. For example, 35% is equivalent to 0.35 or 35/100. The calculator 
> Volume Calculator Ebove can take any two values and calculate the third value. Examples: 


> Triangle Calculator 


> Number Sequence Calculator 5 percent of 30 =? 


? percent of 30 = 1.5 
» Pregnancy Calculators 5 percent of? = 1.5 


) Other Calculators 


) Calculators for Your Site 


Script ef Cookies  FirePath 
body * table.panel <* digitfbntent < td * tr + tbody * table * body * html 
E <td valign="middlewBlign="center"> 
<input id="cpari" type="text" style="text-align: right;" value="" size="10” name="cparl"> 


=" =" 


<input id="cpar2"” type="text” style="text-align: right;” value=”"” size="10" name="cpar2"> 
<input id="cpar3" type="text" style="text-align: right;"” value="" size="10" name="cpar3"> 
</td> 


import java.util.concurrent.TimeUnit; 
import org.openga.selenium.*; 


import org.opengqa.selenium.firefox.FirefoxDriver; 


public class webdriverdemo 


1 


public static void main(String[] args) throws InterruptedException 


1 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 10 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 


driver.navigate().to("http://www.calculator.net 


85 


EH tutorialspoint 


SIMPLYEASYLEARNING 


Selenium 


/percent-calculator.html"); 


// Maximize the browser 


driver.manage().window().maximize(); 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


Thread.sleep(5000) ; 


// Get the text box from the application 
String result = 


driver.findElement(By.id("cpar1")).getAttribute("value"); 


// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


// Close the Browser 


driver.close(); 


Output 
The output of the above script is displayed as shown below. 


X te [E Console 2 
<terminated> webdriverdemo [Java Application] CProgram Files aval jre8binljavaw,exe (5 Aug 2014 7:47:48 pm) 
The Result is 10 
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Radio Button Interaction 


In this section, we will understand how to interact with Radio Buttons. We can 
select a radio button option using the 'click' method and unselect using the same 
"click" method. 


Let us understand how to interact with radio buttons using 
http://www.calculator.net/mortgage-payoff-calculator.html. We can also check if 
a radio button is selected or enabled. 


Home / Financial Calculators / Mortgage Payoff Calculator 


Mortgage Payoff Calculator 


The Mortgage Payoff Calculator is used to determine your current mortgage payoff schedule based 
on a fixed interest. You can choose to pay off your loan altogether, and see the costs, or view the 
Auto Loan Calculator effects of an additional monthly payment, This calculator can also give outthe interest saved and the 
new loan schedule. 


'w Financial Calculators 
> Mortgage Calculator 


» Loan Calculator 


Interest Calculator 

Real Estate Calculator [y] Modify the values and click the button to use 
Take-Home-Pay Calculator 

Existing Loan Amount $ 300000 600000 EM old payment 
500000 old balance 


MM old interest 
Amortization Calculator Interest Rate 6% El new payment 


Payment Calculator 
Retirement Calculator Existing Loan Term 30 years 


Investment Calculator Time Remaining 25 years 0 months MM new balance 


. EM new interest 
(9) Payoff altogether - 


House Affordability Calculator 3 Payoffwith additional $ 500 per month 


Compound Interest Calculator Calculate $ 


Inflation Calculator 
Lease Calculator 


Finance Calculator | Summary 


With additional $500.00 monthly payment, you can payoffthe loan in 15 years 8.00 months. ltis 9 


Mortgage Payoff Calculato y , 
years 4.00 months earlier than the old schedule. You will save $108,886.04 of interest. 


> 
> 
2 
> 
> 
> 
> 
> Currency Calculator 
> 
> 
> 
> 
> 
» 
> 


Refinance Calculator 
BS Script DOM Net GBokies  FirePath 


dy * table*cal...le.panel fF' div.leftinput + divécontent *+ td + tr * tbody * table * body * html 


j <td colspan="3"> 
<input id="cpayoff1” type="radio"” value="together” name="cmonthoryear”"> 
Payoff altogether 
<br> 
<input id="cpayof£2" type="radio"” checked="" value="monthly" name="cmonthoryear"> 
Payoffí with additional $ 
<input id="cadditiocnal"” type="text" style="text-align: right;” value="S00" size="2" name="cadditional"> 


per month 


import java.util.concurrent.TimeUnit; 
import org.openga.selenium.*; 


import org.openqa.selenium.firefox.FirefoxDriver; 


public class webdriverdemo 


1 


public static void main(String[] args) throws InterruptedException 


d 
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WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 109 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) ; 


// Launch website 
driver.navigate().to("http://www.calculator.net 
/mortgage-payoff-calculator.html"); 


driver.manage().window().maximize(); 


// Click on Radio Button 
driver.findElement(By.id("cpayoff1")).click(); 


System.out.println("The Output of the IsSelected " + 
driver.findElement(By.id("cpayoff1")).isselected()); 


System.out.println("The Output of the IsEnabled " + 
driver.findElement(By.id("cpayoff1")).isEnabled()); 


System.out.println("The Output of the IsDisplayed " + 
driver.findElement(By.id("cpayoff1")).isDisplayed()); 


driver.close(); 


// Close the Browser. 


driver.close(); 


Output 


Upon execution, the radio button is selected and the output of the commands 
are displayed in the console. 
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[2 Problems | (2 Javadoc [, Declaration KT Results of running suite E) Console ¿3 


| <terminated> webdriverdemo [Java Application] CProgram FilesWava!jreS! bin javaw.exe (5 Aug 2014 12:03:03 pm) 
The Output of the IsSelected true 

The Output of the IsEnabled true 

The Output of the IsDisplayed true 


Check Box Interaction 


In this section, we will understand how to interact with Check Box. We can select 
a check box using the "click" method and uncheck using the same 'click' method. 


Let us understand how to interact with a check box using 
http://www.calculator.net/mortgage-calculator.html. We can also check if a 
check box is selected/enabled/visible. 


Home / Financial Calculators / Mortgage Calculator 


Mortgage Calculator 
» Mortgage Calculator 


Loan Calculator (w) Modify the values and click the button to use 


Auto Loan Calculator 


Interest Calculator Home Price $. 300000 ¡Monthly Pay: $1,168.04 | 


Real Estate Calculator Down Payment 20 % Monthly 


Y Financial Calculators 


Total 
Take-Home-Pay Calculator Loan Term 30 years Mortgage Payment $1,168.04  $420,496.17 
Payment Calculator Interest Rate 4.16 % Property Tax $300.00  5108,000.00 


Retirement Calculator Home Insurance $100.00 $36,000.00 
Amortization Calculator [Y] Include Optionals Below Other Costs $250.00 $90,000.00 


Currency Calculator ome Insurance $ 1200 lyear 


House Affordability Calculator PMI Insurance $ 0 lyear House Price $300,000.00 


Compound Interest Calculator HOAFee $ 0 ear Loan Amount $240,000.00 


Inflation Calculator y 
OtherCosts $ 3000 year Down Payment $60,000.00 


Lease Calculator Total of 360 Mortgage Payments $420,496.17 
StartDate Aug + 2014 
Finance Calculator Total Interest $5180,496.17 


Mortgage Payoff Calculator Calculate H% 


> 

> 

> 

> 

> 

> 

> 

> 

> Investment Calculator Property Taxes 12 % Total Out-of-Pocket 51,818.04  5654,496.17 
> 

> 

> 

> 

> 

> 

? Mortgage Payoff Date Aug. 2044 
> 


Refinance Calculator 
5S Script DOM Net Cookies 


d * tr < tbody * table * td * tr ly < table <+ divécontent * td * tr < tbody * table * body * html 


E <tr> 


] <tr> 
E <td colspan="3"> 
<br> 


<input id="caddoptional” type="checkbox” checked="” value="1” name="caddoptional"> 
<b> Include Optionals Below</b> 
</label> 
</td> 


import java.util.concurrent.TimeUnit; 
import org.openga.selenium.*; 


import org.openqa.selenium.firefox.FirefoxDriver; 
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public class webdriverdemo 


p 


public static void main(String[] args) throws InterruptedException 


( 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 19 seconds 


// before throwing exception 


driver.manage().timeouts().implicitlywWait(109, TimeUnit.SECONDS); 


// Launch website 


driver. 


navigate().to("http://www.calculator.net 


/mortgage-calculator.html"); 


driver. 


manage().window().maximize(); 


// Click on check box 


driver. 


System. 


driver. 


System. 


driver. 


System. 


driver. 


driver. 


findElement(By.id("caddoptional")).click(); 


out.println("The Output of the Isselected " + 
findElement(By.id("caddoptional")).isselected()); 


out.println("The Output of the IsEnabled " + 
findElement(By.id("caddoptional")).isEnabled()); 


out.println("The Output of the IsDisplayed " + 
findElement(By.id("caddoptional")).isDisplayed()); 


close(); 
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Output 
Upon execution, the check box is unchecked after the click command (as it was 
checked by default) and the output of the commands are displayed in the 
console. 


[2 Console $3 


Nr ults of Tunning 


terminated> webdriverdemo [Java Application] CProgram Files Java! jre8binjavaw.exe (5 Aug 2014 12:09:07 pm) 
The Output of the IsSelected false 


The Output of the IsEnabled true 
The Output of the IsDisplayed true 


Dropdown Interaction 


In this section, we will understand how to interact with Dropdown Boxes. We can 
select an option using 'selectByVisibleText' or 'selectByIndex' or 'selectByValue' 
methods. 


Let us understand how to interact with a  dropdown box 
http://www.calculator.net/interest-calculator.html. We can also check 
dropdown box is selected/enabled/visible. 


using 
if a 


Home / Financial Calculators / Interest Calculator 


Interest Calculator 


This is a fixed-rate compound interest calculator which provides the value for interest and the final 
balance ifyou save a fixed amount and/or save periodically. You can also consider these values with 
respect to tax and inflation. For periodic savings, you can choose to save atthe beginning or at the 
end of each period. You can choose the type of compound interest you receive. To understand the 
difference between types of compound interest, please check the Compound Interest Calculator. 
The APY (Annual Percentage Yield) given by bankis normally the interest rate compounded 
annually 


(y) Modify the values and click the button to use 


¡Results | 
$56,641.10 
548,859.11 
545,000.00 


¡w Financial Calculators Print 


> Mortgage Calculator 
> Loan Calculator 
> Auto Loan Calculator 


) Interest Calculator 


> Real Estate Calculator 
> Take-Home-Pay Calculator 


> Payment Calculator 


vv 


Retirement Calculator 


20000 
Annual Contribution 5 5000 


Amortization Calculator Starting Principal $ 


Investment Calculator End Balance 


Currency Calculator Monthly Contribution 5 0 After Inflation Adjustment 


House Affordability Calculator Total Principal 


Contribute atthe (9) beginning Ú end 


Compound Interest Calculator 
Inflation Calculator 

Lease Calculator 

Finance Calculator 


Mortgage Payoff Calculator 


> 
> 
> 
> 
> 
> 
> 
> 
> 
> 


Refinance Calculator 


CSS Script DOM Net Cookies 


tr * tbody * table*cal...le.panel < div.leftinpu 


E <tr> 
di <tr> 
=) <tr> 
<td> Compound </td> 
E <td align="right"> 


of each compounding period 


Interest Rate 6% 


Compound 


After 


annually + 


Tax Rate 


Infintinm 


FirePath 


divétcontent * td 


O] <select id="ccompound” style="width: 20px;" name="ccompound”> 
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Total Interest 511,641.10 


* body * html 
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import java.util.concurrent.TimeuUnit; 


import org.openga.selenium.*; 


import org.openqa.selenium.firefox.FirefoxDriver; 


import org.opengqa.selenium.support.ui.Select; 


public class webdriverdemo 


( 


public static void main(String[] args) throws InterruptedException 


( 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 19 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 
driver.navigate().to("http://www.calculator.net 
/interest-calculator.html"); 


driver.manage().window().maximize(); 

// Selecting an item from Drop Down list Box 
Select dropdown = 

new Select(driver.findElement(By.id("ccompound”"))); 
dropdown.selectByVisibleText("continuously"); 

// you can also use dropdown.selectByIndex(1) to 
// select second element as index starts with 0. 


// You can also use dropdown.selectByValue("annually"); 


System.out.println("The Output of the IsSelected " + 
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driver.findElement(By.id("ccompound")).isSelected()); 


System.out.println("The Output of the IsEnabled " + 
driver.findElement(By.id("ccompound")).isEnabled()); 


System.out.println("The Output of the IsDisplayed " + 
driver.findElement(By.id("ccompound”)).isDisplayed()); 


driver.close(); 


Output 


Upon execution, the dropdown is set with the specified value and the output of 
the commands are displayed in the console. 


¡£/ Problems (1 Javadoc [íl Declaration H Results of running suite E Console ¿2 


<terminated> webdriverdemo [Java Application] CAProgram Files Java jre8bin'javaw.exe (5 Aug 2014 8:28:19 pm) 
The Output of the IsSelected false 

The Output of the IsEnabled true 

The Output of the IsDisplayed true 


Synchronization 


To synchronize between script execution and application, we need to wait after 
performing appropriate actions. Let us look at the ways to achieve the same. 


Thread.Sleep 


Thread.Sleep is a static wait and it is not a good way to use in scripts, as it ¡is 
sleep without condition. 


Thread.Sleep(1000); //Will wait for 1 second. 


Explicit Waits 
An 'explicit wait' waits for a certain condition to occur before proceeding further. 
It is mainly used when we want to click or act on an object once it is visible. 
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WebDriver driver = new FirefoxDriver(); 
driver.get("Enter an URL"S); 


WebElement DynamicElement = (new WebDriverWait(driver, 
10)).until(ExpectedConditions.presenceOfElementLocated(By.id("DynamicEle 
ment”"))); 


Implicit Wait 
Implicit wait is used in cases where the WebDriver cannot locate an object 
immediately because of its unavailability. The WebDriver will wait for a specified 
implicit wait time and it will not try to find the element again during the specified 
time period. 


Once the specified time limit is crossed, the WebDriver will try to search the 
element once again for one last time. Upon success, it proceeds with the 
execution; upon failure, it throws an exception. 


It is a kind of global wait which means the wait is applicable for the entire driver. 
Hence, hardcoding this wait for longer time periods will hamper the execution 
time. 


WebDriver driver = new FirefoxDriver(); 
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 
driver.get("Enter an URL"); 

WebElement DynamicElement = driver.findElement(By.id("DynamicElement")); 


Fluent Wait 


A FluentWait instance defines the maximum amount of time to wait for a 
condition to take place, as well as the frequency with which to check the 
existence of the object condition. 


Let us say we will 60 seconds for an element to be available on the page, but we 
will check its availability once in every 10 seconds. 


Wait wait = new FluentWait(driver) 
.WwithTimeout(60, SECONDS) 
.pollingEvery(10, SECONDS) 
.ignoring(NoSuchElementException.class); 


WebElement dynamicelement = wait.until(new 
Function<webdriver,webElement>() 


( 
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public WebElement apply(WebDriver driver) 
1 


return driver.findElement(By.id("dynamicelement")); 


) 
);5 


Drag 8 Drop 


As a tester, you might be in a situation to perform a 'Drag 8 drop' operation. We 
will perform a drag and drop operation by picking up a tree grid that is available 
for us on 
http://www.keenthemes.com/preview/metronic/templates/admin/ui_tree.html. 


In the example, we would like to drag an element 'Disable Node' from 'initially 
open' folder to 'Parent Node' Folder. 


Parent Node 


Initially selecte 


A. Custom Icon 
initially open 
Another node 
Another Custom Icon 
Disabled Node 
E: a Sub Nodes 
Another Node 


Note! Opened and selected nodes will be saved in the user's browser, so when returning to the 


same tree the previous state will be restored. 


import java.util.concurrent.TimeUnit; 

import org.opengqa.selenium.*; 

import org.openqa.selenium.firefox.FirefoxDriver; 
import org.openqa.selenium.interactions.Actions; 


import org.openqa.selenium.interactions.Action; 
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public class webdriverdemo 


( 


public static void main(String[] args) throws InterruptedException 


ñ 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 19 seconds 


// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) ; 


// Launch website 


driver.navigate().to("http://www.keenthemes.com/preview/ 


metronic/templates/admin/ui_tree.html")>; 


driver.manage().window().maximize(); 


WebElement From = 


driver.findElement(By.xpath(".//*[Mid="3j3_7']/a")); 


WebElement To = 
driver.findElement(By.xpath(".//*[(Mid="j3_1']/a")); 


Actions builder = new Actions(driver)'; 

Action dragAndDrop = builder.clickAndHold(From) 
.moveToElement(To) 
.release(To) 
.«build(); 

dragAndDrop.pertform(); 


driver.close(); 
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Output 
After performing the drag-drop operation, the output would be as shown below. 


El Parent Node 


E 4 Custom Icon 
Ej Initially open 
Another node 
: pu Another Custom Icon 
E]- B Sub Nodes 
i Another Node 


Note! Opened a lected nodes will be saved in the user's browser, so when returning to the 


same tree the p s state will be restored, 


Keyboard Actions 


Given below are the methods to perform keyboard actions: 


. sendKeys - Sends keys to the keyboard representation in the browser. 
Special keys that are not text, represented as Keys are recognized both as 
part of sequences of characters, or individually. 


. pressKey - Press a key on the keyboard that is NOT text. The keys such 
as function keys "F1", "F2", "Tab", "Control", etc. If keyToPress is a 
sequence of characters, different driver implementations may choose to 
throw an exception or to read only the first character in the sequence. 


e releaseKey - Release a key on the keyboard after executing the keypress 
event. It usually holds good for non-text characters. 


Here are the syntax to call keyboard functions using Selenium WebDriver. 


void sendKeys(java.lang.CharSequence keysToSend) 
void pressKey(java.lang.CharsSequence keyToPress) 


void releaseKey(java.lang.CharsSequence keyToRelease) 


Mouse Actions 


Listed below are some of the key mouse actions that one would come across in 
most of the applications: 
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Click - Performs a Click. We can also perform a click based on 
coordinates. 


contextClick - Performs a context click/right-click on an element or 
based on the coordinates. 


doubleClick - Performs a double-click on the webelement or based on the 
coordinates. If left empty, it performs double-click on the current location. 


mouseDown - Performs a mouse-down action on an element or based on 
coordinates. 


mouseMove - Performs a mouse-move action on an element or based on 
coordinates. 


mouseUp - Releases the mouse usually followed by mouse-down and 
acts based on coordinates. 


Here are the syntax to call mouse actions using Selenium WebDriver: 


void 
void 
void 
void 
void 
void 


void 


click(WebElement onElement) 
contextClick(WebElement onElement) 
doubleClick(WebElement onElement) 
mouseDown(WebElement onElement) 
mouseUp(WebElement onElement) 
mouseMove(WebElement toElement) 


mouseMove(WebElement toElement, long xOffset, long yOffset) 


Multi Select Action 


Sometimes we would be in a situation to select two or more items in a list box or 
text area. To understand the same, we would demonstrate multiple selection 
from the list using 
'http://demos.devexpress.com/aspxeditorsdemos/ListEditors/MultiSelect.aspx. 


Example 


Let us say, we want to select 3 items from this list as shown below: 
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Selection mode: Multiple 


Phone features: Accepted models: 


36 Model 
Bluetooth 


Memory Card Slot 
Touch screen 


ECO 


Voice Dialing 


Wi-Fi 


Let us see how to code for this functionality : 


import java.util.List; 


import java.util.concurrent.TimeUnit; 


import org.openga.selenium.*; 
import org.opengqa.selenium.firefox.FirefoxDriver; 
import org.openqa.selenium.interactions.Actions; 


import org.openqa.selenium.interactions.Action; 


public class webdriverdemo 

1 
public static void main(String[] args) throws InterruptedException 
1 


WebDriver driver = new FirefoxDriver(); 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


driver.navigate().to("http://demos.devexpress.com 


/aspxeditorsdemos/ListEditors/MultiSelect.aspx"); 


//driver.manage().window().maximize(); 


driver.findElement(By.id("ContentHolder_lbSelectionMode_1")).click(); 
driver.findElement(By.id("ContentHolder_lbSelectionMode 
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_DDD_L_LBI1T0")).click(); 


Thread.sleep(5000) ; 


// Perform Multiple Select 
Actions builder = new Actions(driver)'; 
WebElement select = 
driver.findElement(By.id("ContentHolder_lbFeatures_LBT")); 
List<WebElement> options = select.findElements(By.tagName("td")); 
System.out.println(options.size()); 
Action multipleselect = builder.keyDown(Keys.CONTROL) 
.Click(options.get(2)) 
.Click(options.get(4)) 
.Click(options.get(6)) 
.«build(); 
multipleselect.perform(); 


driver.close(); 


Upon executing the script, the items would be selected as displayed above and 
the size of the list box would also be printed in the console. 


Ñ te E Console $2 


<terminated> webdriverdemo [Java Application] CiProgram Files Java'jreSlbinjavaw.exe (6 Aug 2014 12:27:57 am) 


Number of items in the List box is 9 
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Find All Links 


Testers might be in a situation to find all the links on a website. We can easily 


do so by finding all elements with the Tag Name "a", as we know that for any 
link reference in HTML, we need to use "a" (anchor) tag. 


Example 


import org.openga.selenium.*; 

import org.opengqa.selenium.firefox.FirefoxDriver; 
public class getalllinks 

1 


public static void main(String[] args) 

1 
WebDriver driver = new FirefoxDriver(); 
driver.navigate().to("http://www.calculator.net"); 
java.util.List<WebElement> links = 
driver.findElements(By.tagName("a")); 
System.out.println("Number of Links in the Page is " + 
links.size()); 
for (int i = 1; i<=links.size(); i-i+1) 
1 


System.out.println("Name of Linkt " + i - + 


links.get(i).getText()); 


Output 


The output of the script would be thrown to the console as shown below. Though 
there are 65 links, only partial output is shown below. 
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[5 Problems | (1 Javadoc e, Declaration [E Console $ 


<terminated> webdriverdemo [Java Application] CAProgram Files Wava'jre8binijavaw.exe (30 Jul 2014 8:00:04 pm) 

Number of Links in the Page is 65 

Name of Link* 0 - calculator.net 

Name of Link* 1 - put this calculator on your website 

Name of Link* 2 - Financial 

Name of Link* 3 - Mortgage 

Name of Link* 4 - Loan 
5 
6 
7 
8 
9 


Name of Link Auto Loan 
Name of Link+ Interest 
Name of Linkk Take-Home-Pay 
Name of Link:k Payment 
Name of Link+*+ Retirement 
Name of Link* 18 - Amortization 
Name of Link* 11 - Investment 
Name of Link 12 - House Affordability 
Name of Link* 13 - Compound Interest 
Name of Link* 14 - Inflation 
Name of Link* 15 Lease 
Name of Link* 16 - Finance 
Name of Link* 17 - Mortgage Payoff 
Name of Link* 18 - Refinance 
Name of Link* 19 - Interest Rate 
Name of Link* 28 - Weight Loss 
Name of Link* 21 - BMI 
Name of Link* 22 - Calorie 
Name of Link* 23 - Army Body Fat 
Name of Link* 24 - Body Fat 
Name of Link* 25 - BMR 
of Link* 26 - Weight Watchers Points 
of Link* 27 - Anorexic BMI 
of Link* 28 - Carbohydrate 
of Link* 29 - Ideal Weight 


e T 
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9. TEST DESIGN TECHNIQUES 


There are various components involved in designing the tests. Let us understand 
some of the important components involved in designing a framework as well. 
We will learn the following topics in this chapter: 


e Page Object Model 

e Parameterizing using Excel 
e Log4j Logging 

e Exception Handling 

e Multi Browser Testing 

e Capture Screenshots 


e Capture Videos 


Page Object Model 


Selenium acts on webelements with the help of their properties such ID, name, 
XPath, etc. Unlike QTP which has an inbuilt object repository (OR), Selenium has 
no inbuilt ORs. 


Hence we need to build an OR which should also be maintainable and accessible 
on demand. Page Object Model (POM) is a popular design pattern to create an 
Object Repository in which each one of those webelements properties are 
created using a class file. 


Advantages 


e POM is an implementation where test objects and functions are separated 
from each other, thereby keeping the code clean. 


e The objects are kept independent of test scripts. An object can be 
accessed by one or more test scripts, hence POM helps us to create 
objects once and use them multiple times. 


e Since objects are created once, it is easy to access as well as update a 
particular property of an object. 


POM Flow Diagram 


Objects are created for each one of the pages and methods are developed 
exclusively to access to those objects. Let us use http://calculator.net for 
understanding the same. 


103 


EY) tutorialspoint 


Selenium 


There are various calculators associated with it and each one of those objects in 
a particular page is created in a separate class file as static methods and they all 
are accessed through the 'tests' class file in which a static method would be 
accessing the objects. 


Objects are Created as “Static” methods 


Percent Calculator Page Time Calculator Area Calculator Page 
Objects Page Objects Objects 


Percent Calculator Tests Time Calculator Test Area Calculator Test 


Tests Can Directly access objects as <<ClassName.MethodName>> as they are static 


Example 
Let us understand it by implementing POM for percent calculator test. 
Step 1: Create a simple class (page_objects_perc_calc.java) file within a 


package and create methods for each one of those object identifiers as shown 
below. 


package Page0bject; 

import org.openga.selenium.*; 
public class page_objects_perc_calc 
E 


private static WebElement element = null; 


// Math Calc Link 


public static WebElement 1nk_math_calc(WebDriver driver) 


1 
element = 
driver.findElement(By.xpath(".//*[(Mid='menu']/div[3]/a")); 
return element; 

J 
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// Percentage Calc Link 

public static WebElement Ink _percent_calc(WebDriver driver) 

1 
element = 
driver.findElement(By.xpath(".//*[(Mid='menu']/div[4]/div[3]/a")); 


return element; 


// Number 1 Text Box 


public static WebElement txt_num_1(WebDriver driver) 


1 
element = driver.findElement(By.id("cpar1")); 


return element; 


// Number 2 Text Box 


public static WebElement txt_num_2(WebDriver driver) 


1 
element = driver.findElement(By.id("cpar2")); 


return element; 


// Calculate Button 


public static WebElement btn_calc(WebDriver driver) 


1 
element = 
driver.findElement(By.xpath(".//*[(Mid='content']/table/tbody 
/tr/td[2]/input")); 
return element; 

y 

// Result 


public static WebElement web_result(WebDriver driver) 
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1 
element = 
driver.findElement(By.xpath(".//*[(fMid='content']/p[2]/span/font/b")>)); 
return element; 

J 


h 


Step 2 : Create a class with main and import the package and create methods 
for each one of those object identifiers as shown below. 


package Page0bject; 


import java.util.concurrent.TimeUnit; 


import org.openga.selenium.WebDriver; 


import org.openqa.selenium.firefox.FirefoxDriver; 


public class percent_calculator 


( 


private static WebDriver driver = null; 


public static void main(String[] args) 

1 
driver = new FirefoxDriver(); 
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) ; 


driver.get("http://www.calculator.net"); 


// Use page Object library now 
page objects perc_calc.lnk_math_calc(driver).click(); 


page objects perc_calc.lnk percent_calc(driver).click(); 


page objects perc_calc.txt_num_1(driver).clear(); 
page objects perc_calc.txt_num_1(driver).sendKeys("10")>; 
page objects perc_calc.txt_num_2(driver).clear(); 


page objects perc_calc.txt_num 2(driver).sendKeys("50"); 
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page objects perc_calc.btn_calc(driver).click(); 


String result = 


page objects perc_calc.web_result(driver).getText(); 


if(result.equals("5")) 


1 

System.out.println(" The Result is Pass"); 
J 
else 
1 

System.out.println(" The Result is Fail"); 
y 


driver.close(); 


Output 


The test is executed and the result is printed in the console. Given below is the 
snapshot of the same. 


Ñ te E Console 52 
<terminated> percent_calculator [Java Application] CAProgram Files Javaljre8! binjavaw.exe (3 Aug 2014 10:21:44 am) 
The Result is Pass 
A A A A 


Data Driven using Excel 


While designing a test, parameterizing the tests is inevitable. We will make use 
of Apache POI - Excel JAR's to achieve the same. It helps us read and write into 
Excel. 


Download JAR 
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Step 1: Navigate to the URL - http://poi.apache.org/download.html and 
download the ZIP format. 


Apache POI - Download 


Tent Datraction 
Encryptian support Available Downloads 
Cane Studies 
This page provides instructions on how ta download and verify the Apache POI release artifacts. Apache PO: 
see the project homepags. 
. Tia lala JALaz atada calaana ls. Apache POL 3.10-FINAL 


or roleajes 
Apache POI releases are available under the Apache License, Version 2.0, See the NOTICE file contamed in e 
To insure that you have downloaded the true relsase you should venfy the integoty of the files using the 


Subrersien Repesitory 
o To Mslid 
ibubon Suidelimes 


8 February 2014 - PO1 3._10-FINAL available 


Ths Apache POl team is pleased to anmounce the release of 3,10-FINAL. This includes a large mumber of b 
A full bst of changes is avalable im the change log. People mterested should also follow the dev lint to track 


The POÍ source release as wel as the pre-bullt binary deployment packages are listed below. Pre-built verso 


rd "org.apache po” and Version *2.10-FINAL”. 


- AguerSara (MULF + «ELS 
OpeniMLa) (OONML) 
.OL82 Mieeyatem (PO1798) Binary Distribution 


OLEZ Document Props 


Ars « pocbin-3.10-FINAL-20140208.1aC.9Z ( 16MB, sgned) 
MD5 checksum: 319 dieotaroles has i622bazt950s 


*Quidoox (MSME) 
«Vialia (HOG 
-TMEF (MMEF) R 
Publisher (HDSF) ; 2 PA ¿0E-21p , ugned) 
cksum: 430= 1b9023169 9697 Aldo 216: Z 4583 26 3 
SHA1 checksum: 204£ 4dfsc 175b0c 


HAL chechsum. 35b0 


The Apache Software Foundation 


Apache Download Mirrors 


We suggest the following mirror site for your download: 


Date modified 


/2014 10:30 AM 
.- F73 /07/2014 8:18 AM 
ln] chromedriver.exe 1/05/2014 1:38 PM 
Y chromedriver_win32 (1).zip 1/08/2014 12:24 AM 
[17] JEDriverServer.exe 19/02/2014 6:45 PM 
$ poi-bin-3.10-FINAL-20140208.zip 3/08/2014 10:30 AM 
Y selenium-java-2.42.2.zip 27/07/2014 8:17 AM 


4) selenium-server-standalone-2.42.2,jar 27/07/2014 7:42 AM 


Step 4 : Unzipped contents would be displayed as shown below. 
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PERSONAL DOCS » Selenium Trials » JAR » poi-bin-3.10-FINAL-20140208 » poi-3.10-FINAL » 


th New folder 


Name 


ly docs 
£s lib 


2 ooxml-lib 
|| LICENSE 


| poi-3.10-FINAL-20140208.jar 
4) poi-examples-3,10-FINAL-20140208.jar 
poi-excelant-3.10-FINAL-20140208,jar 
|) poi-ooxml-3.10-FINAL-20140208.jar 
[| poi-ocoxml-schemas-3.10-FINAL-2014020... 1/02/2014 6:00 PM 
2) poi-scratchpad-3.10-FINAL-20140208.jar 1/02/2014 6:00 PM 


| run | 
lAs 
La 


Date modified Type 


1/02/2014 6:00 PM 
1/02/2014 6:00 PM File folder 
1/02/2014 6:00 PM File folder 
16/01/20148:37 AM File 


File folder 


Executable Jar File 1,906 KB 
Executable Jar File 306 KB! 
Executable Jar File 30 KB* 
1,008 Kg? 
4,831 KB4 


1,212 KB” 
dl 


1/02/2014 6:00 PM 
1/02/2014 6:00 PM 
1/02/2014 6:00 PM 
1/02/2014 6:00 PM Executable Jar File 
Executable Jar File 


Executable Jar File 


Step 5 : Now create a new project and add all the 'External JARs' under 'poi- 
3.10.FINAL' folder. 


mao ty 


AS AZ 


O Mes lava Projec 
Jawa Settings 


Define the Jinca build settings. 


«2 Sowce | 1o> Proyecas | IM Librares |), Onser and Esport 
JARs and class folders on the lud pati 


Oi a e poi-bm-3.10-FINAL-20.. 


Organiza > 


New fokdes 


docs 


¿ hb 


 ocumi-lb 

4. por-310-ANAL-20140208 jas 
, por-exemples-3.10-FINAL - 20140208 ¡ar 

4. por-excelant-3.10-FINAL - 20140208 jar 

4, pol-cowmb-3.10-FINAL- 20180208 jar 

4) poi-ccwmi-<<hemas-310-FINAL- 20140208 jar 
sw, porscratchpad-310-HNAL- 20140208 jar 


Add External Clas Foldes...| 


Step 6 : Now add all the 'External JARs' under the 'ooxml-lib' folder. 
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(O tir Jus Project 
o Het 
CE ANN pas 
Ñ LAA Defare the Jeva build settings. 


12% Source | leS Projects: E Libranes |, Oeder and bxpon! 
| JAR ara class folders on the build pate 


Date modéled 


18/01/1014 142 AM Cutable dar File MN KB 
161/1014 43 AM PEsecutable lar Flo PUN S! 


15/M1/2014 443 AM secutaltile dar File 2.505 KB 


ligrate JAR Fún 


Jawa Settings 
Define tre Java budd eettings. 


48 Son | 1 Peje) 88 Libres |, Order and Esper 


JARs and class fobers on the build pato 


Drake mudiied 
2, comenpm-codec-1.5 je 161/2014 242 AM 
2 comenom-loggrg-11 je 16207014 642 AM stable Lar Fdo 
a, part 11 jar 1611/2014 2:42 AM zertable Jar Fán 
e dot) 1213 jar 16:01,2014 8:42 4M JReerutabie lar Fás 


Begrete LAN File 
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Step 8 : The Added JAR is displayed as shown below. 


3 New Java Project 
Java Settings 
Define the Java build settings. 


L% Source | L> Projects | E Libraries | %; Order and Export | 


JARs and class folders on the build path; 


commons-codec-1,5,jar - DAPERSONAL DOCSiSelenium Trials JAR poi-bin-3,10-FINAL-208 
cormmons-logging-1.1.jar - DAPERSONAL DOCS¡Selenium TrialsWARipoi-bin-3.10-FINAL-2( 
dom4j-1.6,1.jar - DAPERSONAL DOCSSelenium Trials JAR poi-bin-3.10-FINAL-20140208' pd] 
junit-4.11,jar - DAPERSONAL DOCSiSelenium Trials JARipoi-bin-3,10-FINAL-20140208'poi-: 
log4j-1,2,13.jar - DAMPERSONAL DOCSiSelenium Trials JAR poi-bin-3.10-FINAL-201402081p o! 
poi-3.10-FINAL-20140208.jar - DMPERSONAL DOCSiSelenium Trials JAR poi-bin-3.10-FINA Add Library... 
poi-examples-3.10-FINAL-20140208.jar - D:YPERSONAL DOCS¡Selenium Trials JAR'poi-bin-3 
poi-excelant-3.10-FINAL-20140208,jar - D:APERSONAL DOCS1Selenium Trials JAR poi-bin-3; Add Class Folder... 
poi-ooxml-3.10-FINAL-20140208,jar - DAPERSONAL DOCS¡Selenium TrialsJARipoi-bin-3,10 
poi-ooxml-schemas-3.10-FINAL-20140208,jar - DAPERSONAL DOCS¡Selenium Trials JAR pol 
poi-scratchpad-3.10-FINAL-20140208.jar - PERSONAL DOCS¡Selenium Trials JAR'poi-bin 
stax-api-1.0.1.jar - DAPERSONAL DOCSiSelenium Trials JAR poi-bin-3.10-FINAL-201402081 pl 

a. xmlbeans-2,3,0 jar - DPERSONAL DOCS¡Selenium Trials JAR poi-bin-3,10-FINAL-20140208 FEE 
>» 2 JRE System Library [JavaSE-1.8] 


j 


MEME 


Add Variable... 


E 


H 
2 


y 


2 
o. 


NENE 


E 
S 


Ni 


2 
S. 


Add External Class Folder... 


IE 


2 
o. 


Edit... 


TENEN 


Migrate JAR File... 


Finish ] | Cancel ] 


Step 9 : The Package Explorer is displayed as shown below. Apart from that, 
add 'WebDriver' related JAR's 
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Package Explorer ¿3 
a [12 DataDriven| 
E% src 
a Eh JRE System Library [JavaSE-1.8] 
> (3 resources.jar - CiProgram FilesWava'jre8Vlib 
rtjar - CA Program FilesWava'yre8 lib 
sse.jar - CA Program Files Wava!jre8! lib 
jce.jar - CAProgram Files ava'yre8 lib 


JLS 


a 


charsets.jar - C;¡ ¡Program Files Java!jre8! lib 
jfr.jar - CAProgram Files Uava'jre8 lib 


DEE 


s 
3 


access-bridge-64.jar - Ci Program FilesiJavayreBMibied 


Di 


E 
E 


cldrdata.jar - ChProgram Files ava!jr 


A) 


9 
10 


dnsns.jar - CA Pr 
jaccess.jar - CiProgram Fil j 
fxrt.jar - CA Program FilesWava'jre8 il 
localedata.jar - C: Program Files Java yre 
nashorn.jar - CAProgram Files Uavaljre8liblext 
(ona sunec.jar - Ci Program Files JavayreSiblext 
la sunjce provider.jar - C3 Program Files reBWibled 
(ad sunmscapijar - Ci Program Filesiav 
las sunpkes11 jar - Ci Program File 
a zipfs.jar - CAProgram FilesWavayre8Miblexd 
4 Ex) Referenced Libraries 
lus poi-3.10-FINAL-20140208.jar - DAPERSONAL DOCSSelenium TrialsJARipoi-bin-3.10-FINAL-201402081poi-3.10-FINAL 
im poi-examples-3,10-FINAL-20140208,jar - D AL DOCS Selenium Trials JAR poi-bin-3.10-FINAL-20140208'poi-3,10-FINAL 
sn poi-excelant-3.10-FINAL-20140208,jar - D:PER: A enium Trials JAR'poi-bin-3.10-FINAL-20140208'poi-3,10-FINAL 
la poi-ooxml-3,10-FINAL-20140208.jar - DPERSON 0-FINAL-201402 i-3.10-FINAL 
a poi-ooxml-schemas-3.10-FINAL-20140208.jar - D: OCAS Mpoi-bin-3,10-FINAL-201402081 poi-3.10-FINAL 
m9 poi-scratchpad-3,10-FINAL-20140208.jar - D: PERSONAL DOCS Selenium Trials JAR b 0-FINAL-201402081f 0 
Y dom4j-1.6.1,jar - PERSONA OCSSelenium Trials AR poi-bin-3,10-FINAL-2014( Apoi-3,10-FINAL00xmi-lib 
o stax-api-1.0.1.jar - D PERSONA lenium TrialJARpoi-bin-3,10-FINAL-20140 0-FINAL o0oxmi-lib 
9 xmlbeans-2,3.0.jar - DA PERSONA enium Trials JAR poi-bin-3.10-FINAL-20140 1-3,10-FINAL o0oxmi-lib 
a commons-codec-1.5.jar - D: PERSON O- -20140 )01-3,10-FINAL lib 
a commons-logging-1.1.jar - D: PE A S 3.10-FINA poi-3.10-FINAL lib 
Ex) junit-4.11.jar - DAPERSONAL DOCS'Seleniumn TrialsJARipoi-bin-3 02081 poi-3.10-FINALNlib 
log4j-1.2.13,jar - DAPERSONAL DOCSSelenium Trials JARipor-bin-3.10-FINAL-201402081po:1-3.10-FINAL lib 


Parameterization 


For demonstration, we will parameterize the percent calculator test. 


Step 1 : We will parameterize all the inputs required for percent calculator using 
Excel. The designed Excel is shown below. 


D 


A B £ 
TestName [Numi_ |Num2 |ExpectedResult 
[Percent Calculator [so [2005 [601s | 
Percent Calculator [1035 [som [575 | 


Step 2: Execute all the percent calculator functions for all the specified 
parameters. 
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Step 3: Let us create generic methods to access the Excel file using the 
imported JARs. These methods help us get a particular cell data or to set a 
particular cell data, etc. 


import java.io.*; 


import org.apache.poi.xssf.usermodel.*; 


public class excelutils 

1 
private XSSFSheet ExcelWSheet; 
private XSSFWorkbook ExcelWBook ; 


//Constructor to connect to the Excel with sheetname and Path 


public excelutils(String Path, String SheetName) throws Exception 
1 


try 
1 
// Open the Excel file 
FileInputstream ExcelFile = new FilelInputStream(Path); 
// Access the required test data sheet 
ExcelWBook = new XSSFWorkbook(ExcelFile); 
ExcelWSheet = ExcelWBook.getSheet(SheetName) ; 
ha 
catch (Exception e) 
1 
throw (e); 
E 


// This method is to set the rowcount of the excel. 
public int excel get_rows() throws Exception 
1 

try 

1 
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return ExcelWSheet .getPhysicalNumberOfRows(); 


P 
catch (Exception e) 
1 
throw (e); 
E 


// This method to get the data and get the value as strings. 
public String getCellDataasstring(int RowNum, int ColNum) throws Exception 
1 
try 
1 
String CellData = 
ExcelWSheet .getRow(RowNum) .getCell(ColNum) .getStringCellValue(); 
System.out.println("The value of CellData " + CellData); 


return CellData; 


J 
catch (Exception e) 
1 
return "Errors in Getting Cell Data”; 
J 


// This method to get the data and get the value as number. 
public double getCellDataasnumber(int RowNum, int ColNum) throws Exception 
1 
try 
1 
double CellData = 
ExcelWSheet . getRow(RowNum).getCell1(ColNum).getNumericCellValue(); 
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System.out.println("The value of CellData " + CellData); 


return CellData; 


J 


catch (Exception e) 


í 
return 000.00; 


y 


Step 4 : Now add a main method which will access the Excel methods that we 
have developed. 


import java.io.*; 


import org.apache.poi.xssf.usermodel.*; 


public class excelutils 

1 
private XSSFSheet ExcelWSheet; 
private XSSFWorkbook ExcelWBook; 


//Constructor to connect to the Excel with sheetname and Path 
public excelutils(String Path, String SheetName) throws Exception 
pi 


try 

1 
// Open the Excel file 
FileInputstream ExcelFile = new FilelInputStream(Path) ; 
// Access the required test data sheet 
ExcelWBook = new XSSFWorkbook(ExcelFile); 
ExcelWSheet = ExcelWBook.getSheet(SheetName) ; 

J 


catch (Exception e) 
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throw (e); 


// This method is to set the rowcount of the excel. 


public int excel get_rows() throws Exception 


1 
try 
1 
return ExcelWSheet.getPhysicalNumberOfRows(); 
J 
catch (Exception e) 
1 
throw (e); 
y 
y 


// This method to get the data and get the value as strings. 
public String getCellDataasstring(int RowNum, int ColNum) throws Exception 
1 
try 
1 
String CellData = 
ExcelWSheet . getRow(RowNum) .getCell(ColNum).getsStringCellValue(); 
// Cell = ExcelWSheet.getRow(RowNum).getCel1(ColNum) ; 
// String CellData = Cell.getStringCellValue(); 
System.out.println("The value of CellData " + CellData); 
return CellData; 


J 


catch (Exception e) 


ji 
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return "Errors in Getting Cell Data"; 


// This method to get the data and get the value as number. 


public double getCellDataasnumber(int RowNum, int ColNum) throws Exception 


1 
try 
1 
double CellData = 
ExcelWSheet.getRow(RowNum).getCel1(ColNum).getNumericCellValue(); 
// Cell = ExcelWSheet.getRow(RowNum) .getCell(ColNum) ; 
// String CellData = Cell.getStringCellValue(); 
System.out.println("The value of CellData " + CellData); 
return CellData; 
J 
catch (Exception e) 
1 
return 000.00; 
J 
J 
J 
Output 


Upon executing the script, the output is displayed in the console as shown 
below. 
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<terminated> datadriven [Java Application] CiProgram Filesavaljre8lbinjavaw.exe (3 Aug 2014 5:58:30 pm) 


The 
The 
The 
The 
The 
The 
The 
The 
The 
The 


The 
The 
The 
The 


Value of c is 5 

value of CellData 10.25 
value of CellData 50.56 
Act Result is 5.1824 
value of CellData 5.1824 
Exp Result is 5.1824 
value of CellData 20.55 
value of CellData 40.66 
Act Result is 8.35563 
value of CellData 8.35563 
Exp Result is 8.35563 
value of CellData 30.0 
value of CellData 208.5 
Act Result is 60.15 
value of CellData 60.15 
Exp Result is 60.15 
value of CellData 103.5 
value of CellData 508.0 
Act Result is 517.5 
value of CellData 517.5 
Exp Result is 517.5 


Log4j Logging 


Selenium 


Log4j is an audit logging framework that gives information about what has 


happened during execution. It offers the following advantages: 


Enables us to understand the application run. 
Log output can be saved that can be analyzed later. 


Helps in debugging, in case of test automation failures. 


Can also be used for auditing purposes to look at the application's health. 


Components 


1. Instance of Logger class. 


2. Log level methods used for logging the messages as one of the following: 


. error 
e warn 
e info 
e debug 
e log 
Example 


Let us use the same percent calculator for this demo. 


(Y) tutorialspoint 


118 


Selenium 


Step 1 : Download log4j JAR file from 
https: //logging.apache.org/log4j/1.2/download.html and download the Zipped 
format of the JAR file. 


Last Published: 2012-03-13 | Version 1:32:17 | Apacrra > Loggma Fericer > 094 > 1.7 


Download Apache log4j 1.2.17 


Apache log4] 1,2.17 is distributed under the Apache License, version 2,0 1, 


The mk im the Mirrors coksmn should display a list of available mirrors with a default selection based 
sonature are links to the onginaís on the main distribution server 


Mittota ] 


Apacho 1199)-3.2:17 (E-GE]" 


Apache log4 1.2.17 (2p) 


Documentation 
a informaton 


Prouyea: Repons 


It is essential that you venfy the integrity of the downloaded files using the PGP or MDS signatures 
our releases 


The PGP signatures can be venfad using PGP or GPS. First download the KEYS 0 as well as the asc 
directory 0, rather than from a mirror. Then verify the signatures using 


* oro 1 
* 09 -—Y 


Ctri+WW 
Ctri+Shift+W j Class 


Package 
Close All 


Save Ctrl+S ins 


Save As... 
Save All 
Revert 


Enum 
Ctrl+Shift+S Sa 
Source Folder 
Java Working Set 


Move... Folder 


Rename... 
Refresh 


Convert Line Delimiters To 


File 
Untitled Text File 
JUnit Test Case 


Print... Ctrl+P 


Ctrl+N 


CA O! 


Other... 


Switch Workspace 
Restart 


Import... 
Export... 


Properties Alt+Enter 


1 Logger.class [org.apache.log4j.Logger] 
2 log4j.properties [Log4;] 
3 excelutils.java [DataDriven/src] 


4 datadriven.java [DataDriven/src] 


Exit 
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Step 3 : Enter the name of the project as 'log4j_demo' and click 'Next'. 


< New Java Project 


Create a Java Project 


Create a Java project in the workspace or in an external location. 


Project name: log4j_demo 


[4] Use default location 


DAPERSONAL DOCSSelenium Trialsilog4j demo 


JRE 


O) Use an execution environmentJRE: |JayaSE-1.8 


) Use a project specific JRE: jre8 


Use default JRE (currently 'jre8') Configure JREs... 


Project layout 
_) Use project folder as root for sources and class files 
O) Create separate folders for sources and class files Configure default... 
Working sets 


[7] Add project to working sets 


< Back Next > Cancel 


Step 4 : Click Add External Jar and add 'Log4j-1.2.17.jar'. 


2 JAR Selection 


CIO 1, « Selenium Trials » log4jJARS y [4 


Organize y New folder 


Date modified 


14) logáj-1.2.17.jar 6/05/2012 1:01 PM 
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Step 5 : Click Add External Jar and add Selenium WebDriver Libraries. 


O Tie 1601 Prriert 


Java Settings 
Defira thw laxa pude sattorega. 


9 Source 1 Ira PE Libres |, Order al Epor: 
Mila and chars inóder: en tino push path 


== logAj 1.217 y + DAPERSONAL DOCS Selesiuen Tesla loa ARS 
má RE Syaterm Library JleweSE-1 E 


Dr selios 


Go Jess radares. > sede dADÍ » 


Orgarera » Mera hoktes 4 hd3 Chess blades — 
dado Esterri! Cayos Foios - 


Mos 
Lat... 
runas - pera ¿AL jar 


selenasir java 242 2 0040 IMA 1041 4 Esariaido das Fáe Lemoa 


” 
Fla rama: "selenio AD 2 jm redes + 


L_Spm 


Step 6 : Click Add External Jar and add Selenium WebDriver JAR's located in the 
Libs folder. 


O vien lia Purgert 


lava Settings 


Dedme the lesa husta retire 


¿A sontce | ler Praga: ME Libres , Codes and Export 
JARA aná ers holders en he buda path 
pu dog 1 2.17 gas - DA PERSONAL DOCH Seen Tal dog lar Mdd MAS 
». selena ja a 272 9000 + DA PERSONAL DOCH Setenta Teal! JAR Setenasror jara ZA 2D sedermar ZA Z 
+ melena jura 2412 a - DOPERSONAL DOCS Selene Trial a aterra jara 2418 ale 242 pal Eaurs Dido: 
PS seo Added Yi pevabaón 


Add > 
Ade Cins Foie... 
dskt Estero! Clara Fohdas 
apacta-mnidj db jar 
hib-13.0 jas 
» <gitrrmdes-21_J9 
> comenprr-<adec-1 9 jar 
correnora-coderbons-121 ¿as 
commons eser-1.1 ar 
cormenams 10-24 jar 
comnoes path 3 jar 
commons -langd-321 jar 


cormenoas-logana-1 4.1401 
in 


Fit name “cgib-nodep-21 ya” "common +» jara 
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Step 7 : Add a New XML file using which we can specify the Log4j properties. 


O teva > Eclipse 

file Edr Source Refecior PHevigote Segrch Project Bun Window Het 
ni. 2-0 -4-50-0M ¿> o 

[1 Package Explere > Praject Explorer Le 


w 
logá; demo 


m Open mn New Window e: 
Package 
Class 
Iimetace 
Ervsm 
Anmotation 
Source Folder 


leva Wordong Set 
Budd Path ' 


sd Goles 
2000 e 
Refactor Alt Shift=T TERMAL 


import. — JUnmit Test Case 


Jona Propert 


1 fe 


Open Type Hierarchy 
Show ln 


Copy 

a Copy Queliñied Mame 
Paste 

KM Delete 


1] o o G He 


a 
3 


la Enpor, ChieM 


Retren FS 


Assign Working Sets. 


Debug As 

Run As 

Team 
Compare With 


Restore from Local History 


Alt-Enter 


Step 8 : Enter the Logfile name as 'Log4j.xml". 


File 


Create a new file resource, 


Enter or select the parent folder: 
log4j_demo/src 
a [2 logáj_demo 
(5 «settings 
(5 bin 
(5 src 
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Step 9 : The final folder structure is shown below. 


a [2 log4j demo 
8 src 


E, JRE System Library [a 
mí, Referenced Libraries 


E] log4j.xml 
Step 10 : Now add the properties of Log4j which would be picked up during 


execution. 


<?xml version="1.0" encoding="UTF-8">> 
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> 
<1log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" 
debug="false"> 
<appender name="fileAppender" 
class="org.apache.log4j.FileAppender”> 
<param name="Threshold" value="INFO" /> 
<param name="File" value="percent_calculator.log"/> 
<layout class="org.apache.log4j.PatternLayout"> 
<param name="ConversionPattern" value="%dfyyyy -MM-dd 
HH:mm:ss) [%c] (%t:%x) %m%n" /> 
</layout> 
</appender> 
<root> 
<level value="INFO"/> 
<appender-ref ref="fileAppender"/> 


</root> 


</1l0g43:configuration> 


Step 11 : Now for demonstration purpose, we will incorporate log4j in the same 
test that we have been performing (percent calculator). Add a class file in the 


'Main' function. 


package log4j_demo; 

import org.apache.log4j.LogManager; 

import org.apache.log4j.Logger; 

import org.apache.log4j.xml.DOMConfigurator; 
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import java.util.concurrent.TimeuUnit; 
import org.openga.selenium.*; 


import org.opengqa.selenium.firefox.FirefoxDriver; 


public class log4j_demo 
1 


static final Logger logger = 
LogManager.getLogger(1log4j_demo.class.getName()); 


public static void main(String[] args) 


1 
DOMConfigurator.configure("log4j.xml"); 


logger.info("Ht 4H HHHHHRARARARARARARACHARAREAS); 
logger.info("TEST Has Started"); 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 109 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS) ; 


// Launch website 
driver.navigate().to("http://www.calculator.net/"); 


logger.info("Open Calc Application"); 


// Maximize the browser 


driver.manage().window().maximize(); 


// Click on Math Calculators 
driver.findElement(By.xpath(".//*[(Mid='"menu']/div[3]/a")).click(); 
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logger.info("Clicked Math Calculator Link"); 


// Click on Percent Calculators 
driver.findElement(By.xpath(".//*[(fMid='menu']/div[4]/div[3]/a")) 
.Cclick(); logger.info("Clicked Percent Calculator Link"); 


// Enter value 18 in the first number of the percent Calculator 
driver.findElement(By.id("cpar1")).sendKeys("10"); 


logger.info("Entered Value into First Text Box"); 


// Enter value 50 in the second number of the percent Calculator 
driver.findElement(By.id("cpar2")).sendKeys("50"); 


logger.info("Entered Value into Second Text Box"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(Mid='content']/table 
/tbody/tr/td[2]/input")).click(); 

logger.info("Click Calculate Button"); 


// Get the Result Text based on its xpath 
String result = 
driver.findElement(By.xpath(".//*[(Mid='content'] 
/p[2]/span/font/b")).getText(); 

logger.info("Get Text Value"); 


// Print a Log In message to the screen 


logger.info(" The Result is " + result); 


if(result.equals("5")) 


1 
logger.info("The Result is Pass"); 
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J 


else 


A 
logger.error("TEST FAILED. NEEDS INVESTIGATION"); 


logger.info("+ 4 +44+444+444444444444+144+4+444445%); 


// Close the Browser. 


driver.close(); 


Execution 


Upon execution, the log file is created on the root folder as shown below. You 
CANNOT locate the file in Eclipse. You should open 'Windows Explorer' to show 
the same. 


omputer » DataDisk (D:) » PERSONAL DOCS » Selenium Trials » log4j demo » 


clude in library + Share with w New folder 


A 


Name Date modified Type 


«settings 4/08/2014 10:09 PM File folder 
bin 4/08/2014 10:16PM  Filefolder 
Ly src 4/08/2014 10:16PM  Filefolder 
|] «classpath 4/08/2014 10:11 PM  CLASSPATH File 
/08/2014 10:09 PM PROJECT File 
AlML Document 
/08/2014 10:17 PM Text Document 


[10943_demo.1094]1 _Gemo] ([main:) $ $ 44 444941494 940490999094090909999409 
(10315_demo.log47_demo] (main:) TEST Has Etarted 
[10943_damo.1034]_ dano] (main:) Open Calc Application 
[10943_demo.loq4j_deno] (main: Clicked Math Csiculator Link 
[1log43_demo.log4j_damo] (main:) Clicked PFercent Calculator Link 
[10443_demo.10943_deno] (main;) Entered Value into First Text Box 
(log43_domo.log4j_deno] (main:) Entored Value into Second Text Box 
[10943 _damo.1034] Gamo] (main:) Click Calculate Button 
[109143_demo.log43_demo] (main:) Get Text Value 
[10g43_damo.log4)_ demo] (main:) The Result ig 
[10913_demo.1loq14j_deno] (main: The Result 1 
o.log4j_demo] ([main:) PF 4FEFPFF94949949490404404414494399$ 
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Exception Handling 


When we are developing tests, we should ensure that the scripts can continue 
their execution even if the test fails. An unexpected exception would be thrown if 
the worst case scenarios are not handled properly. 


If an exception occurs due to an element not found or if the expected result 
doesn't match with actuals, we should catch that exception and end the test in a 
logical way rather than terminating the script abruptly. 


Syntax 


The actual code should be placed in the try block and the action after exception 
should be placed in the catch block. Note that the 'finally' block executes 
regardless of whether the script had thrown an exception or NOT. 


try 
1 
// Perform Action 
J 
catch(ExceptionTypel expl1) 
1 
// Catch block 1 
J 
catch(ExceptionType2 exp2) 
1 
// Catch block 2 
J 
catch(ExceptionType3 exp3) 
1 
// Catch block 3 
y 
finally 
1 


// The finally block always executes. 
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Example 
If an element is not found (due to some reason), we should step out of the 
function smoothly. So we always need to have a try-catch block if we want to 
exit smoothly from a function. 


public static WebElement Ink _percent_calc(WebDriver driver)throws Exception 
1 
try 
1 
element = 
driver.findElement(By.xpath(".//*[Mid='menu']/div[4]/div[3]/a")); 
return element; 
E 
catch (Exception el) 
1 
// Add a message to your Log File to capture the error 
Logger.error("Link is not found."); 
// Take a screenshot which will be helpful for analysis. 
File screenshot = 
((TakesScreenshot)driver).getsScreenshotAs(OutputType.FILE); 
FileUtils.copyFile(screenshot, new 
File("D:IMframeworkXXscreenshots.jpg")); 
throw(el); 
J 
J 
Multi Browser Testing 


Users Can execute scripts in multiple browsers simultaneously. For 
demonstration, we will use the same scenario that we had taken for Selenium 
Grid. In the Selenium Grid example, we had executed the scripts remotely; here 
we will execute the scripts locally. 
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all, ensure that you have appropriate drivers downloaded. Please refer 


the chapter "Selenium Grid" for downloading 1E and Chrome drivers. 


Example 


For demonstration, we will perform percent calculator in all the browsers 
simultaneously. 


import 
import 
import 
import 
import 


import 


public 
1 


package TestNG; 


org.openqa.selenium.chrome.ChromeDriver; 
org.openqa.selenium.firefox.FirefoxDriver; 
org.opengqa.selenium.ie.InternetExplorerDriver; 
java.util.concurrent.Timeunit; 
org.opengqa.selenium.*; 


org.testng.annotations.*; 


class TestNGClass 


private WebDriver driver; 


private String URL = "http://www.calculator.net”; 


AParameters("browser") 


MABeforeTest 
public void launchapp(String browser) 
1 
if (browser.equalsIgnoreCase("firefox")) 
1 
System.out.println(" Executing on FireFox"); 
driver = new FirefoxDriver(); 
driver.get(URL); 
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 
driver.manage().window().maximize(); 
y 


else if (browser.equalsIgnoreCase("chrome")) 
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1 
System.out.println(" Executing on CHROME"); 
System.out.println("Executing on IE"); 
System.setProperty("webdriver.chrome.driver", 
"D:Michromedriver.exe"); 
driver = new ChromeDriver()'; 
driver.get(URL); 
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 
driver.manage().window().maximize(); 

A 

else if (browser.equalsIgnoreCase("ie")) 

1 
System.out.println("Executing on IE"); 
System.setProperty("webdriver.ie.driver", 
"D:IMIEDriversServer.exe"); 
driver = new InternetExplorerDriver(); 
driver.get(URL); 
driver.manage().timeouts().implicitlywWait(10, TimeUnit.SECONDS); 
driver.manage().window().maximize(); 

J 

else 

1 
throw new IllegalArgumentException("The Browser Type is Undefined"); 

J 

4 
(ATest 


public void calculatepercent() 
í 
// Click on Math Calculators 
driver .findElement(By.xpath(".//*[(Mid='menu']/div[3]/a")).click(); 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(Mid='menu']/div[4]/div[3]/a")).click(); 
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// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(Mid='"content']/table/tbody/ 
tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 

String result = 
driver.findElement(By.xpath(".//*[(Mid='content']/p[2]/span 
/font/b")).getText(); 


// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


if(result.equals("5")) 


1 
System.out.println(" The Result is Pass"); 


System.out.println(" The Result is Fail"); 
E 


MAfterTest 


public void closeBrowser() 


( 


driver.close(); 
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Create an XML which will help us in parameterizing the browser name and don't 
forget to mention parallel="tests" in order to execute in all the browsers 
simultaneously. 


HE Package Explorer ¿3 O | [E] testngxml ¿2 


1<2xml version="1.0" encoding="UTF-8"2>> 
2 <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.8.dtd”> 


3 <suite name="Suite” parallel="tests"> 
ES TestNG 5 <parameter name="browser" value="firefox" /> 
El, JRE System Library [JavaS5E-1.8 6 <classes> 
E TestNiG 7 <class name="TestNG.TestiWGClass” /> 


3 3 </classes> 
E, Referenced Libraries 9 testo 


155 est-outoul La 
[E] testng.xml —ÉK——— > 
2 <test name="ChromeTest"”> 


<parameter name="browser" value="chrome"” /> 

4 <classes> 

5 <class name="TestNG.TestiWGClass” /> 
</classes> 

</test> 


<test name="IETest”> 
<parameter name="browser"” value="ie" /> 
<classes> 
<class name="TestNG.TestiGClass” /> 
</classes> 
</test> 


27 </suite> 
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Execute the script by performing right-click on the XML file and select 'Run As' 
>> 'TestNG' Suite as shown below. 


3 Java - TestNGDemo/testngxml - Eclipse 
File Edit Source Refactor Navigate Search Project Run Window Help 


mi ARO A OA DEA 


FE Package Explorer 22 BS +0 ml|Ejtestrgami 33 


1] selrcdemo 1<23xml version="1.0" encoding="UTF-8"?> 
a E TestNGDemo 2 <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.8.dtd"> 
6% stc 3<suite name="Suite"” parallel="tests"> 
> , Mapa 4  <test name="FirefoxTest”> 
El JRE System Library [lavaSE-1,8 5 <parameter name="browser" value="firefox" /> 
Ex) Testi 6 <classes> 
E) Referenced Libraries 7 <class name="TestNG.TestiiGClass" /> 
[5 test-output 8 </classes> 
Bl testngxmall g </test> 
lU WebDrive! New 


name="ChromeTest"> 

rameter name="browser" value="chrome" /> 
Open With asses> 

Show In Alt=Shift=W » <class name="TestNWG.TestNGClass” /> 
lasses> 

> 


Open 


Copy Ctrl+ € 
Copy Qualified Name 


Paste Ctrl=V name="IETest"> 


rameter name="browser” value="ie" /> 
Delete Delete  lasses> 
<class name="TestNG.TestNGClass” /> 
Build Path » ¡lasses> 


Refactor Alt+Shift+T » P 


y Import... 
Export... 


P Refresh 
Assign Working Sets... 


Debug As 


» T 1 TestNG Suite Alt+Shift+X, G 


Run Configurations... 
Compare With 


Replace With 


TestNWG 


Properties Alt+Enter 


Output 


All the browsers would be launched simultaneously and the result would be 
printed in the console. 


Note : To execute on IE successfully, ensure that the check box 'Enable 
Protected Mode' under the security tab of 'IE Option' is either checked or 
unchecked across all zones. 
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avadoc Declaration XÑ Results of running surte E Console $2 


[TestNG] Running: 
D:APERSONAL DOCS 1Selenium Trials1TestNGDemoltestng.xml 


Executing on CHROME 
Executing on IE 
Executing on IE 
Executing on FireFox 
Starting ChromeDriver (v2.18.267521) on port 37977 
Only local connections are allowed. 
Started InternetExplorerDriver server (64-bit) 
2.40.0.0 
Listening on port 15717 
The Result is 5 
The Result is Pass 
The Result i 
Result i 
Result i 
Result i 


d Te men 


. Wes ¿VD PERSOMAL ENOCO SS GeternDTT et TED tU des herir >» bo E 


Test results 
, ==> 7 


FuefoxTem (1 clama) 
CismmeTest (1 class) 
TET ret (1 clan) 


MN Penta al runrerz uta 


Leach hPa 1 Dre dogped 1 


E hn Tegs ¡dh reded Tess Suero 
e bo: pote AO 1 JU ITO 
e fi OrrerraTest 17881 as 
e hi] Testi00 Tetis 
lo] cabcaleteperrea O BES 3] 
e hi; PambacTant [ 185% 4] 
e y IG TENGO 


bj; Tantr 40. Y esthi0 Ciara 
ba) otorgante! G0AR $) 
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Capture Screenshots 


This functionality helps to grab screenshots at runtime when required, in 
particularly when a failure happens. With the help of screenshots and log 
messages, we will be able to analyze the results better. 


Screenshots are configured differently for local executions and Selenium Grid 
(remote) executions. Let us take a look at each one them with an example. 


Localhost Execution 


In the following example, we will take a screenshot after calculating the 
percentage. Ensure that you give a valid path to save the screenshot. 


import java.io.File; 
import java.io.IOException; 


import java.util.concurrent.TimeuUnit; 


import org.apache.commons.io.FileUtils; 
import org.openga.selenium.*; 


import org.opengqa.selenium.firefox.FirefoxDriver; 


public class webdriverdemo 


( 


public static void main(String[] args) throws IOException 


( 


WebDriver driver = new FirefoxDriver(); 


// Puts an Implicit wait, Will wait for 10 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 


driver.navigate().to("http://www.calculator.net/"); 


// Maximize the browser 


driver.manage().window().maximize(); 
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// Click on Math Calculators 
driver.findElement(By.xpath(".//*[(Mid='"menu']/div[3]/a")).click(); 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(Mid='menu']/div[4]/div[3]/a")).click(); 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(id='content']/table 
/tbody/tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 

String result = 

driver .findElement(By.xpath(".//*[(Mid='content']/p[2] 
/span/font/b")).getText(); 


File screenshot = 


((TakesScreenshot)driver).getsScreenshotAs(OutputType.FILE); 


FileUtils.copyFile(screenshot, new 


File("D:Iiscreenshotsiiscreenshots1.jpg")); 


// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


// Close the Browser. 


driver.close(); 
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Output 


Upon executing the script, the screenshot is saved in the 'D:1screenshots' folder 
with the name 'screenshots1.jpg' as shown below. 


Computer DataDisk(D:) » screenshots 


Share with New folder 


A 


Include in library + 
Name 


31 screenshotsl.jpg 


Selenium Grid — Screenshot Capture 


While working with Selenium Grids, we should ensure that we are taking the 
screenshots correctly from the remote system. We will use augmented driver. 


Example 


We will execute the script on a Firefox node attached to a hub. For more on 
configuring hub and nodes, please refer the Selenium Grids chapter. 


package TestNG; 


import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 


import 


org.openqa.selenium.remote.Augmenter; 


org.opengqa.selenium.remote.DesiredCapabilities; 


org.openqa.selenium.TakesScreenshot; 
java.util.concurrent.Timeunit; 
org.openga.selenium.*; 
org.testng.annotations.AfterTest; 
org.testng.annotations.BeforeTest; 
org.testng.annotations.Parameters; 
org.testng.annotations.Test; 
java.io.File; 

java.net.URL; 
java.net.MalformedURLException; 


org.apache.commons.io.FileUtils; 
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import org.openqa.selenium.remote.RemoteWebDriver; 


import java.io.IOException; 


public class TestNGClass 

1 
public WebDriver driver; 
public String URL, Node; 


protected ThreadLocal<RemoteWebDriver> threadDriver = null; 


(AParameters("browser"”) 
(ABeforeTest 
public void launchapp(String browser) throws MalformedURLException 
1 
String URL = "http://www.calculator.net”; 
if (browser.equalsIgnoreCase("firefox")) 
1 
System.out.println(" Executing on FireFox"); 
String Node = "http://10.112.66.52:5555/wd/hub” ; 
DesiredCapabilities cap = DesiredCapabilities.firefox(); 


cap.setBrowserName("firefox"); 


driver = new RemoteWebDriver(new URL(Node), cap); 
// Puts an Implicit wait, Will wait for 109 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 
driver.navigate().to(URL); 
driver.manage().window().maximize(); 


J 


else 


( 


throw new IllegalArgumentException("The Browser Type is 
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Undefined"); 


(ATest 

public void calculatepercent() throws IOException 

1 
// Click on Math Calculators 
driver.findElement(By.xpath(".//*[Mid='"menu']/div[3]/a")).click(); 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(Mid='menu']/div[4]/div[3]/a")).click(); 


// Make use of augmented Driver to capture Screenshots. 
WebDriver augmentedDriver = new Augmenter().augment (driver); 
File screenshot = 


((TakesScreenshot)augmentedDriver).getScreenshotAs(OutputType.FILE); 


FileUtils.copyFile(screenshot, new 


File("D:Iiscreenshotsilremotescreenshot1.jpg")); 


// Screenshot would be saved on the system where the script is 


// executed and NOT on remote machine. 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver .findElement(By.xpath(".//*[(id='content']/table/tbody 
/tr/td[2]/input")).click(); 
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// Get the Result Text based on its xpath 

String result = 
driver.findElement(By.xpath(".//*[(Mid='content']/p[2] 
/span/font/b")).getText(); 


// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


if(result.equals("5")) 


1 
System.out.println(" The Result is Pass"); 
y 
else 
1 
System.out.println(" The Result is Fail"); 
J 
J 
MAfterTest 


public void closeBrowser() 


( 


driver.quit(); 


Output 


Upon executing the script, the screenshot is captured and saved in the specified 


location as shown below. 
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>) remotescreenhotl jpg 
Sy Calculator.net 


Percent Calculator 


» Webghs Lumen Ende ib 


> Mati Calcule 


Calculate $ 


Capturing Videos 


Sometimes we may not be able to analyze the failures just with the help of a log 
file or a screenshot. At times, it helps to capture the complete execution as a 
video. Let us understand how to capture videos. 


We will make use of Monte Media Library to perform this operation. 
Configuration 


Step 1: Navigate to the URL - http://www.randelshofer.ch/monte/index.html 
and download the screen recorder JAR as shown below. 
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The Monte Media Library is a Java library for processing media data. Supported media formats include still images, video, audio 


and meta-data, 


This is an experimental library for my personal studies! 


Selenium 


This library has some overlap in functionality with the Java Media Framework (JMF). For some codecs, the Monte Media Library 
provides wrappers, which allow to use them with JMF. However, in general, Monte Media is not compatible with JMF. 


Demo Applications 


Most demos consist of an executable JAR file which also includes the source code. On some platforms, you can double click the 
JAR file to execute the demo, on others, you can start it with the command java -Jar nemeofídemo.jar 


To getthe source code, rename the file to nameofdemo. zip and unzip it 


Screen Recorder 
00.0  MonteMedia- 


Creates a screen recording with audio 
and stores itin a movie file, 


The demo code ¡is located in the 
package org.monte.screenrecorder 


MonteScreenRecorderjar 4 


Clickthe launch button to startthe 
recorder: 


Movie Converter 


Converts a movie from one file format 
into another. 


This advanced demo demonstrates the 
use of codec chains, and the ability for 
processing stereo videos created with 
the Fujifilm Real 3D V1 camera. 


Click the launch button to start the 
demo: 


Movie Maker 


20.0 SE 
Tila ds a dema ef the Mente Media Ehbeary. 

Cogyrgha € 3010-3017 Merver Landelhates A nights ener. 

Ver sabran am de da erre dies Corren Camera Arriba £ O 

Dog a tubos wet maga (des jeta tre heñd beive 


e e La 
mos Cm | 4 Po 
Drag 4 100nd Só iran the foc hocdoros Lasa, art, nor, am 
Orse 
Prepara hos ienernel Mrearero 
(0 e pr 
Past tano 


Bass lamot Compresiod becados 


Cross Cuech Trm Mi 


This demo creates a QuickTime movie 
from a folder with image files and an 
audio file. 


The movie is written with the 
QuickTimeWriter class. 


The demo code is located in the class 
org.monte.moviemaker.MovieMakerMain 


MovieMaker ¡ar 
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Step 2: After downloading, add the JAR file to the Libraries of the current 
project. 


Java Build Path 


ETS 

JARs and class folders on the build path: 

1) apache-mime4j-0.6.jar - DMPERSONAL DOCSiSelenium Trials JAR selenium-java-2.42.21selenium-2.42,2Mlibs Add JARs... 
» (1 bsh-13.0.jar - DAPERSONAL DOCSSelenium Trials JAR selenium-java-2.42,21selenium-2.42,2Mlibs 

ny calib-nodep-2.1 3.jar - DAPERSONAL DOCSiSelenium Trials VAR! selenium-java-2.42,21selenium-2.42,2Mlibs Add External JARs.., 
commons-codec-1.9.jar - DAPERSONAL DOCS Selenium Trials JAR selenium-java-2.42,2selenium-2.42.21libs 
commons-collections-3,2.1,jar - DMPERSONAL DOCSSelenium Trials JAR selenium-java-2,42.21selenium-2,42.21/ 
commons-exec-1.1.jar - DPERSONAL DOCSSelenium Trials JAR selenium-java-2.42.21selenium-2,42.2Mlibs Add Library... 
commons-io-2,4.jar - DAPERSONAL DOCS¡Selenium Trials JAR selenium-java-2.42.2selenium-2,42.2libs 
commons-jxpath-1.3,jar - DAPERSONAL DOCS Selenium Trials VAR selenium-java-2,42,2Aselenium-2.42,2Mlibs Add Class Folder... 
commons-lang3-3.2.1.jar - DAPERSONAL DOCS¡Seleniumn Trials JAR! selenium-java-2,42,21 selenium-2,42,2Mlibs 
commons-logging-1.1.3.jar - DiAPERSONAL DOCS'Selenium Trials JARiselenium-java-2.42,21selenium-2.42.2Xlibs 
essparser-0,9,11.jar - DAPERSONAL DOCS1Selenium Trials JAR selenium-java-2.42.21selenium-2.42,2Mlibs E 
guava-15.0.jar - DAPERSONAL DOCSSelenium Trials JAR selenium-java-2,42,21selenium-2,42,21libs 
hamcrest-core-1,3.jar - DAPERSONAL DOCSSelenium Trials JAR selenium-java-2.42.21selenium-2,42.2libs 
a hamcrest-library-1.3.jar - D¡APERSONAL DOCS1Selenium Trials JARselenium-java-2,42.21selenium-2,42.2Vlibs 
9 htmlunit-2.14.jar - DAPERSONAL DOCS1Selenium TrialsUARselenium-java-2.42,21selenium-2.42.2Mlibs 
htmlunit-core-js-2.14.jar - DPERSONAL DOCSSelenium Trials JAR'selenium-java-2.42.21selenium-2.42.2libs 
1 httpclient-4,3,2.jar - DAPERSONAL DOCSiSelenium Trials JAR selenium-java-2.42,21selenium-2.42.2Vlibs 
httpcore-4.3.1.jar - DYPERSONAL DOCSSelenium Trials JAR selenium-java-2.42.2selenium-2.42.2libs 
httpmime-4.3.2.jar - DYPERSONAL DOCS¡Selenium Trials JAR selenium-java-2,42.21 selenium-2,42.2libs 
ini4j-0.5.2.jar - DAPERSONAL DOCS¡Selenium Trials JAR! selenium-java-2.42.2 selenium-2.42.2libs 
jcommander-1,29,jar - DAPERSONAL DOCSiSelenium Trials JAR selenium-java-2,42.2selenium-2.42.2Mlibs 
jetty-websocket-8.1.8.jar - DNPERSONAL DOCSiSelenium Trials JAR selenium-java-2.42.21selenium-2.42.2Mlibs 
jna-3.4.0,jar - DAPERSONAL DOCS'Selenium Trials JAR selenium-java-2.42,21selenium-2.42.2Wlibs 
jna-platform-3.4.0.jar - DAPERSONAL DOCS 1Selenium Trials JAR selenium-java-2,42.2selenium-2.42,2Mlibs 
lle nc D¡APERSONAL poca selenium o -2,42.2 selenium-2,42,2libs 

R - R jaya-2,42,2) selenium-2,42.21libs 


Dl 


Add Variable... 


1EN| 


sz 
3 


s 
3 


Dl 


a 
3. 


Add External Class Folder... 


Di 


Edit... 


[010 


Remove 


¡EII 


Migrate JAR File... 


ENE 


IEEE 


(E 


Step 3 : We will use Java's AWT package to initialize the graphics configuration. 


GraphicsConfiguration gc = GraphicsEnvironment 
.getLocalGraphicsEnvironment() 
.getDefaultScreenDevice() 


.getDefaultConfiguration(); 


Step 4: An instance of ScreenRecorder is created which takes the following 
parameters. 


Parameter Description 


GraphicsConfiguration Provides information about the display 
screen such as size and resolution. 
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Video and compression format The output format (AVI) of the movie with 


number of frames/sec. 


Color of the mouse cursor and Specifies the mouse cursor color and 


refresh rate 


Audio format 


Example 


refresh rate. 


If 'NULL', audio will NOT be recorded. 


We will capture a video of the simple test execution - percent calculation. 


import 
import 


import 


import 


import 
import 
import 


import 


import 
import 


import 


import 
import 


import 


public 
1 


java.io.File; 


java.io.IOException; 


java.util.concurrent.TimeUunit; 


org.apache.commons.io.FileUtils; 


org. 
org. 
org. 


org. 


org. 


org 


org. 


openga. 
openga. 
openga. 


openga. 


selenium.*; 
selenium.firefox.FirefoxDriver; 
selenium.WebDriver; 


selenium.By; 


monte.media.math.Rational; 


.monte.media.Format; 


monte.screenrecorder.ScreenRecorder; 


static org.monte.media.AudioFormatKeys.*; 


static org.monte.media.VideoFormatKeys.*; 


java.awt.*; 


class webdriverdemo 


Et 


LYEAS 


LYE s5sYL 
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private static ScreenRecorder screenRecorder; 
public static void main(String[] args) throws IOException, AWTException 
1 
GraphicsConfiguration gconfig = GraphicsEnvironment 
.getLocalGraphicsEnvironment() 
.getDefaultScreenDevice() 


.getDefaultConfiguration(); 


screenRecorder = new ScreenRecorder(gconfig, 
new Format(MediaTypeKey, MediaType.FILE, MimeTypeKey, 
MIME_AVI), 
new Format(MediaTypeKey, MediaType.VIDEO, EncodingKey, 
ENCODING_AVI_TECHSMITH_SCREEN_CAPTURE, 
CompressorNameKey, ENCODING_AVI TECHSMITH_SCREEN_CAPTURE, 
DepthKey, (int)24, FrameRateKey, Rational.value0f(15), 
QualityKey, 1.0f, 
KeyFrameIntervalKey, (int) (15 * 60)), 
new Format(MediaTypeKey, MediaType.VIDEO, 
EncodingKey,"black", 
FrameRateKey, Rational.value0f(30)), null); 


WebDriver driver = new FirefoxDriver(); 


// Start Capturing the Video 


screenRecorder.start(); 


// Puts an Implicit wait, Will wait for 19 seconds 
// before throwing exception 


driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 


driver.navigate().to("http://www.calculator.net/"); 
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// Maximize the browser 


driver.manage().window().maximize(); 


// Click on Math Calculators 
driver.findElement(By.xpath(".//*[(Qid='menu']/div[3]/a")).click(); 


// Click on Percent Calculators 
driver.findElement(By.xpath(".//*[fMid='menu']/div[4]/div[3]/a")) 
.Click(); 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(id='content']/table 
/tbody/tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 
String result = 
driver.findElement(By.xpath(".//*[(Mid='content'] 
/p[2]/span/font/b")).getText(); 


File screenshot = 


((TakesScreenshot)driver).getscreenshotAs(OutputType.FILE); 


FileUtils.copyFile(screenshot, new 


File("D:IAscreenshotsMiscreenshots1.jpg")); 
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// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


// Close the Browser. 


driver.close(); 


// Stop the ScreenRecorder 


screenRecorder.stop(); 


Output 


The recorded video is saved in the "C:lusersi1<<UserName>>WWideos" folder as 
shown below. 


| + Ci UsersiTuto_pnt Wideos| 


Share with y Play all 


ScreenRecording 
2014-08-05 at 
10.47.34 .avi 


147 


SIMPLYEASYLEARNING 


ES tutorialspoint 


10. TestNG 


What is TestNG? 


TestNG is a powerful testing framework, an enhanced version of JUnit which was 
in use for a long time before TestNG came into existence. NG stands for 'Next 
Generation'. 


TestNG framework provides the following features: 


Annotations help us organize the tests easily. 
Flexible test configuration. 

Test cases can be grouped more easily. 
Parallelization of tests can be achieved using TestNG. 
Support for data-driven testing. 


Inbuilt reporting 


Installing TestNG for Eclipse 


Step 1 : Launch Eclipse and select 'Install New Software'. 


Welcome 


Help Contents 
Search 
Dynamic Help 


Key Assist... Ctrl+Shift+L 
Tips and Tricks... 
Cheat Sheets... 


“oy Check for Updates 


ér+  Install New Software... 


SS) Installation Details 


mp Eclipse Marketplace... 


S About Eclipse 
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Step 2 : Enter the URL as 'http://beust.com/eclipse' and click 'Add'. 


3 Install 
Available Software 


Select a site or enter the location of a site. 


alos 
y 
DE 


type filter text 


Name 
110 There is no site selected. 


Select All | | Deselect All 


Details 


[4] Show only the latest versions of available software 
[4] Group items by category 
Show only software applicable to target environment 


Y] Contact all update sites during install to find required software 


Find more software by working with the "Available Software Sites" preferences. 


Version 


[2] Hide items that are already installed 


What is already installed? 


Step 3 : The dialog box 'Add Repository' opens. Enter the name as 'TestNG' and 


click 'OK' 


< Add Repository 


Name: TestWG 


Location: http://beust.com/eclipse 
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Archive... 
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Step 4 : Click "Select All' and "TestNG' would be selected as shown in the figure. 


3 Install 
Available Software 
Check the items that you wish to install. 


Work with: — TestiNG - http://beust.com/eclipse 


type filter text 


Select All] Deselect All 1 item selected 
Step 5 : Click 'Next' to continue. 


3 Install 


Available Software 
Check the ¡items that you wish to install. 


Work with:  TestiWG - http://beust.com/eclipse 


type filter text 


Name 
[7] 600 TestNG 


_ SelectAll | | DeselectAll 1 item selected 


Details 


[Y] Show only the latest versions of available software 


[4] Group items by category 


[7 Show only software applicable to target environment 


[4] Contact all update sites during install to find required software 


MPLYEASYLEARNING 


a tutorialspoint 


esa) 


7 


DE 


y [add] 


Find more software by working with the “Available Software Sites” preferences. 


Version 


v 


Find more software by working with the "Available Software Sites" preferences. 


Version 


[Y] Hide items that are already installed 


What is already installed? 


era 
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Step 6 : Review the items that are selected and click 'Next'. 


install 


Install Details 
Review the items to be installed. DE 


Name Version Id 
GS TestNiG 6.8.6.20141201 2240 org.testng.eclipse.feature.group 


Size: Unknown 


Details 


Step 7 : "Accept the License Agreement" and click "Finish". 


3 Install 


Review Licenses 


Licenses must be reviewed and accepted before the software can be installed. 


License text (for TestNG 6.8.6.20141201_2240): 


Apache License 

Version 2.0, January 2004 

http://www.apache.org/licenses/ 

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 
1. Definitions. 

"License" shall mean the terms and conditions for use, reproduction, 

and distribution as defined by Sections 1 through 9 of this document. 


1 do not accept the terms of the license agreement 
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Step 8 : TestNG starts installing and the progress would be shown follows. 


3 Installing Software 


O Installing Software 


|] Always run in background 


¡Run in Background | | Cancel | | Details >> | 


Step 9 : Security Warning pops up as the validity of the software cannot be 
established. Click 'Ok'. 


S Security Warning o 0-3] 


Warning: You are installing software that contains unsigned content, The authenticity 
' or validity of this software cannot be established, Do you want to continue with the 


installation? 
Cancel | | Details >> 


Step 10 : The Installer prompts to restart Eclipse for the changes to take effect. 
Click 'Yes”. 


<S Software Updates 


.. ' You will need to restart Eclipse for the changes to take effect. Would you like to 
restart now? 


Annotations in TestNG 


Annotations were formally added to the Java language in JDK 5 and TestNG 
made the choice to use annotations to annotate test classes. Following are some 
of the benefits of using annotations. More about TestNG can be found here. 


e TestNG i¡dentifies the methods it ¡is interested in by looking up 
annotations. Hence, method names are not restricted to any pattern or 
format. 
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e We can pass additional parameters to annotations. 


e Annotations are strongly typed, so the compiler will flag any mistakes 


right away. 

e Test classes no longer need to extend anything (such as TestCase, for 
JUnit 3). 

Annotation Description 


OBeforeSuite The annotated method will be run only once before all the 
tests in this suite have run. 


OAfterSuite The annotated method will be run only once after all the 
tests in this suite have run. 


OBeforeClass The annotated method will be run only once before the first 
test method in the current class is invoked. 


OAfterClass The annotated method will be run only once after all the test 
methods in the current class have run. 


OBeforeTest The annotated method will be run before any test method 
belonging to the classes inside the <test> tag is run. 


QOAfterTest The annotated method will be run after all the test methods 
belonging to the classes inside the <test> tag have run. 


OBeforeGroups The list of groups that this configuration method will run 
before. This method is guaranteed to run shortly before the 
first test method that belongs to any of these groups is 
invoked. 


OAfterGroups The list of groups that this configuration method will run 
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after. This method is guaranteed to run shortly after the last 
test method that belongs to any of these groups is invoked. 


GQBeforeMethod The annotated method will be run before each test method. 


QMAfterMethod The annotated method will be run after each test method. 


GODataProvider Marks a method as supplying data for a test method. The 
annotated method must return an Object[ ][ ] where each 
Object[ ] can be assigned the parameter list of the test 
method. The OTest method that wants to receive data from 
this DataProvider needs to use a dataProvider name equals 
to the name of this annotation. 


OFactory Marks a method as a factory that returns objects that will be 
used by TestNG as Test classes. The method must return 
Object![ ]. 

OListeners Defines listeners on a test class. 


OParameters Describes how to pass parameters to a O'Test method. 


OTest Marks a class or a method as part of the test. 
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TestNG-Eclipse Setup 


Step 1 : Launch Eclipse and create a 'New Java Project' as shown below. 


Annotabor 
Source Folder 
Java Viceting Set 


Folder Tutorials 
Fla Go through butoriale 


3 Untitled Text Fle 
Comvert Line Delimiters To * Juwit Test Case 


Whats New 


End out what a nuw 


Other. 
Seatch Workspece 
Restart 
Import... 
Export... 


Properties 


Step 2 : Enter the project name and click 'Next', 


3 New Java Project 


Create a Java Project 


Create a Java project in the workspace or in an external location. 


Project name; TestNGDemo 


[7] Use default location 
1 | DAPERSONAL DOCS Selenium Trials TestNGDemo 


(0) Use an execution environment JRE; | JayaSE-1.8 


O) Use a project specific JRE: |jre8 " 


(5 Use default JRE (currently 'jre8') Configure JREs... 


Project layout 


(O) Use project folder as root for sources and class files 


(0) Create separate folders for sources and class files Configure default... 


Working sets 
[7] Add project to working sets 


Workin 
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Step 3: Navigate to "Libraries" Tab and add the Selenium Remote Control 
Server JAR file by clicking on "Add External JAR's" as shown below. 


12 Sowrce | 17 Projects Eh Libraries |, Order and Esport 


JARs and class folders on the build path 
má JRE System Library [Java5E-1 8) 


y Selenium Triats » JAR » 


Organ + Hero folder 


selenmmam-java-242.2 


File name: 


Step 4 : The added JAR file is shown here. Click 'Add Library”. 


O Mess taa Project 
Java Settings 
Defene the lava build settings 


M Source | > Projects. Mé Libranez Order and Export 


JARs and class folders on the budd pattr 


sn salerivrn-server-standalone-242.2j0 - DAPERSONAL DOCS Seleriurn Trial Js | Add ARS... 
má JRE System Library [lavsSE-1 4] y 
da Eemal MAR... j 


Add oral 


Add Llosa Folaiet.. 


Abd External Clara Folger... 


Remove 
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Step 5 : The 'Add Library' dialog opens. Select 'TestNG' and click 'Next' in the 
'Add Library" dialog box. 


3 New Java Project [ al Es ES | 
(2 Source | L=> Projects! E% Libraries | %; Order and Export 
)) 


JARs and class folders on the build path: 


| 
> (ua selenium-server-standalone-2.42.2,jar - DAPERSONAL DOCSiSelenium Trials JAR Add JARs... 
> Eh JRE System Library [JavaSE-1.8] 
Add External JARs... 


Add Variable... 


Java Settings 
Define the Java build settings. 


3 Add Library. May dd Library... 
Add Library - Add Class Folder... 
A y Add External Class Folder... 
20d. 


EA | Eto 


Migrate JAR File... 
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Step 6: The added 'TestNG' Library is added and it is displayed as shown 
below. 


< New Java Project 
Java Settings 
Define the Java build settings. 


| 3 Source | > Projects. EX Libraries |“. Order and Export | 
JARs and class folders on the build path: 


> (and selenium-server-standalone-2.42.2.jar - DMPERSONAL DOCS¡Selenium Trials JAR Add JARs... 


item. [_ AddExtermalJARs.... | 


Eá TestNiG 


¿% Access rules: No rules defined Add Variable... 


e Native library location: (None) 
Qu testngijar - DAPERSONAL DOCS Eclipseteclipse-standard-luna-R-win32-86_ Add Library... 


[Add Class Folder... — | 


[Add External Class Folder... ] 


Migrate JAR File.. 


Step 7 : Upon creating the project, the structure of the project would be as 
shown below. 


a 2 TestNGDemo 
0% src 


E JRE System Library [/av25E-1.8] 
.- E, Referenced Libraries 
- 3%, TestiiG 
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Step 8 : Right-click on 'src' folder and select New >> Other. 


File Edit Source Refactor Navigate Search Project Run Window Help 
Al f — A BODA BG A 3 y 


FÉ Package Explorer ¿2 om 


> LY selrcdemo 
“Y TestNGDemo 


Open in New Window 


Java Project 
Project... 


Open Type Hierarchy F4 
Show In Alt+Shift+W » 


Package 
Class 


Copy Ctri+C Interface 


Copy Qualified Name 
Paste Ctrl+V 
Delete Delete 


Enum 
Annotation 
Source Folder 


Java Working Set 
Build Path Pl, Folder 


Source Alt+Shift+S » 
Refactor Alt+Shift+T » 


-$LOQOQACeE JE 


Gx 


$ 


File 
Untitled Text File 
JUnit Test Case 


rr” a 


Export... Z Ctrl+N 


E 


ii 


Import... 


Refresh 
Assign Working Sets... 


Debug As 

Run Ás 

Team 

Compare With 

Restore from Local History... 


TestNG 


Properties Alt+Enter 
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Step 9 : Select 'TestNG' and click 'Next'. 


3 New 


Select a wizard 


Wizards: 
type filter text 


6 Interface 

(E Java Project 

E Java Project from Existing Ant Buildfile 
132 Plug-in Project 


(5 General 
p Es CVS 
. (5 Git 

E Java 

(5 Plug-in Development 
a (2 TestNiG 

Ñ TestNG class 
(> User Assistance 


A —— 
< Back Cancel 


Step 10 : Select the 'Source Folder' name and click 'Ok'. 


3 oler Sra salecion 


New TestNG class 


3 The source folder of an existing project must be specified. 


Select new file container 


Source folder: 5 (2 selrcdemo 
a [2 TestNiGDemo 
Package name: [>> «settings 


Class name: NewTest (3 bin 
(El WebDriverDemo 
Annotations 

7 OBeforeMethod [| DAfterMethod [|] GODataProvider 
QBeforeClass | ]OAfterClass 

[7 OBeforeTest [U OAfterTest 

[7 OBeforeSuite [|] GAfterSuite 


XML suite file: 
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Step 11 : Select the 'Package name', the 'class name', and click "Finish", 
=] 
New TestNG class 
Specify additional information about the test class. 


Source folder: —/TestWGDemofsrc 


Package name: TestWG 


Class name: TestNGClass 


Annotations 

[FP] ABeforeMethod [| GMAfterMethod | ]ODataProvider 
[T] OBeforeClass |] MAfterClass 

| OBeforeTest | OAfterTest 

[] OBeforeSuite [| |MAfterSuite 


XML suite file: 


q 


E Package Explorer ¿3 [5] *TestWGClass java 53 
package TestNG; 


2 selrcdemo 
a [52 TestNGDemo 
p [5 src 
, Ed JRE System Library [JawaSE-1.8] 
Ex) Referenced Libraries 
E) TestiiG 
> [$7 WebDriverDemo 


1 
x 
2 


A 
5 
6 


import org.testng.annotations.Test; 


public class TestiiGClass 
t 


> (Test 
public void f() 
t 


J 


0100 


J 
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First Test in TestNG 


Now let us start scripting using TestNG. Let us script for the same example that 
we used for understanding the WebDriver. We will use the demo application, 
www.calculator.net, and perform percent calculator. 


In the following test, you will notice that there is NO main method, as testiNG will drive the 
program execution flow. After initializing the driver, ¡t will execute the “OBeforeTest' method 
followed by “O Test' and then 'DAfterTest'. Please note that there can be any number of 'OTest' 
annotation in a class but OBeforeTest' and 'ODAfterTest' can appear only once. 


package TestNG; 

import java.util.concurrent.Timeunit; 

import org.opengqa.selenium.*; 

import org.openqa.selenium.firefox.FirefoxDriver; 
import org.testng.annotations.AfterTest; 

import org.testng.annotations.BeforeTest; 


import org.testng.annotations.Test; 


public class TestNGClass 
1 


WebDriver driver = new FirefoxDriver(); 


(ABeforeTest 

public void launchapp() 

1 
//Puts an Implicit wait, Will wait for 10 seconds 
// before throwing exception 
driver.manage().timeouts().implicitlyWait(10, TimeUnit.SECONDS); 
//Launch website 
driver.navigate().to("http://www.calculator.net"); 


driver.manage().window().maximize(); 


(ATest 


public void calculatepercent() 
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// Click on Math Calculators 
driver .findElement(By.xpath(".//*[Mid='"menu']/div[3]/a")).click(); 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(id='"menu']/div[4]/div[3]/a")).click(); 


// Enter value 10 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(id='content']/table 
/tbody/tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 

String result = 
driver.findElement(By.xpath(".//*[(Mid='content']/p[2] 
/span/font/b")).getText(); 


// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


if(result.equals("5")) 
1 
System.out.println(" The Result is Pass"); 


else 


System.out.printlin(" The Result is Fail"); 
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MAfterTest 


( 


driver.close(); 


public void terminatetest() 


Execution 


To execute, right-click on the created XML and select "Run As" >> "TestNG 


Suite" 


3 Java - Eclipse 


File Edit Source Refactor Navigate Search Project Run Window Help 


mo EFRES DASS DAA CA A 


FE Package Explorer 23 
a (2 TestNGDemo 
> ES src 
> E JRE System Library [JavaSE-1.8] 
mí, TestWiG 
> Bah Referenced Libraries 
(5 test-output 
[E) testng 


Open 
Open With 
Show In 
[E Copy 
Es Copy Qualified Name 
Paste 
MX Delete 


Build Path 
Refactor 


de Import... 
ss Export... 
«¿$ Refresh 

Assign Working Sets... 


display at this time. 


» E 1 TestNiG Suite 


Compare With 
Replace With 


TestNG 


Properties 
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Result Analysis 


The output is thrown to the console and it would appear as shown below. The 
console output also has an execution summary. 


3. Problems (2 Javadoc [2 Declaration [E Console 22 Ñ[ Results of running class TestNGClass 

<terminated> TestNGClass [TestNG] CA Program FilesiJavaljreSibinijavaw.exe (31 Jul 2014 8:18:51 am) 

[TestNG] Running: 
C:1UsersTPAAppDatalLocallTempltestng-eclipse-15112785321testng-customsuite.xml 


The Result is 5 
The Result is Pass 
PASSED: calculatepercent 


Default test 
Tests run: 1, Failures: 0, Skips: 0 


Default suite 
Total tests run: 1, 


[TestNG] Ti org.testng.reporters.JUnitReportReporter626b2d4a: 9 ms 
[TestNG] Ti org.testng.reporters.SuiteHTMLReporter(M73a8dfcc: 66 ms 
[TestNG] Ti org.testng.reporters.EmailableReporter2M6f2b958e: 4 ms 
[TestNG] Ti [FailedReporter passed=0 failed=8 skipped=8]: 1 ms 
[TestNG] Time org.testng.reporters.jq.Mainfaec6354: 34 ms 

[TestNG] Time org.testng.reporters.XMLReporterfic2e1f26: 6 ms 


The result of TestNG can also be seen in a different tab. Click on 'HTML Report 
View' button as shown below. 


A A 


Texte 1/1 Mutinada: 1 ALMA rre) 


Saaattr A 


Pe An Tonto Ce Fada Tarta reno 
a lil, Deba ta (100.0 j 307 
e hi Don rut 6302 
a hi TOA T NTC isa 


hi) calcular MO e 


A 
” E A A A AAA 


Test results 


Í anni 
All sustes 
Default suite 


Enfo 


re 
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Selenium Grid is a tool that distributes the tests across multiple physical or 
virtual machines so that we can execute scripts in parallel (simultaneously). It 
dramatically accelerates the testing process across browsers and across 
platforms by giving us quick and accurate feedback. 


Selenium Grid allows us to execute multiple instances of WebDriver or Selenium 
Remote Control tests in parallel which uses the same code base, hence the code 
need NOT be present on the system they execute. The selenium-server- 
standalone package includes Hub, WebDriver, and Selenium RC to execute the 
scripts in grid. 


Selenium Grid has a Hub and a Node. 


e Hub- The hub can also be understood as a server which acts as the 
central point where the tests would be triggered. A Selenium Grid has 
only one Hub and it is launched on a single machine once. 


. Node - Nodes are the Selenium instances that are attached to the Hub 
which execute the tests. There can be one or more nodes in a grid which 
can be of any OS and can contain any of the Selenium supported 
browsers. 
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Architecture 


The following diagram shows the architecture of Selenium Grid. 


Selenium Selenium Test 
Test on on Windows - 
Android 


Selenium Test 
on Linux - 
Firefox 


Selenium GRID 
Server (HUB) 


Web Application 


Working with Grid 


In order to work with the Grid, we need to follow certain protocols. Listed below 
are the major steps involved in this process: 


e Configuring the Hub 

e Configuring the Nodes 

. Develop the Script and Prepare the XML File 
e Test Execution 

e Result Analysis 


Let us discuss each of these steps in detail. 
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Configuring the Hub 


Step 1: Download the latest Selenium Server standalone JAR file from 
http://docs.seleniumhq.org/download/. Download it by clicking on the version as 
shown below. 


í edit this page —— search setenium: MIN 
EY seleniumHQ edit this h sele [Go 


Browser Automation a] Download 


Downloads 

Below is where you can find the latest releases of all the Selenium components. You can also find a 
Latest Releases list of previous releases, source code, and additional information for Maven users (Maven is a popular 

Java build tool). 


Selenium Downloads 


Previous Releases 
Source Code Selenium IDE 


Selenium IDE is a Firefox plugin which records and plays back user interactions with the browser. Use 
this to either create simple scripts or assist in exploratory testing. It can also export Remote Control 
or WebDriver scripts, though they tend to be somewhat brittle and should be overhauled into some 
sort of Page Object-y structure for any kind of resiliency. 


Maven Information 


Donate to Selenium 
Download latest released version 2.5.0 released on 01/Jan/2014 or view the Release Notes and then 


with PayPal install some plugins. 


Donate 
aa Selenium Server (formerly the Selenium RC Server) 
vi [ves que 

The Selenium Server is needed in order to run either Selenium RC style scripts or Remote Selenium 
through sponsorship Webdriver ones. The 2.x server is a drop-in replacement for the old Selenium RC server and is 
You can sponsor the Selenium  Jesigned to be backwards compatible with your existing infrastructure, 
project if you'd like some public 
recognition of your generous 
contribution. To use the Selenium Server in a Grid configuration see the wiki page. 


Download versio 


Step 2: Start the Hub by launching the Selenium Server using the following 
command. Now we will use the port '4444' to start the hub. 


Note : Ensure that there are no other applications that are running on port+* 
4444, 


java -jar selenium-server-standalone-2.25.0.jar -port 4444 -role hub - 
nodeTimeout 1000 


| ido aytemiZ cmd e > es jar "DO PERSONAL DOCS Seterum Tras JA selenmn series iprdaone-2AZZ jar” port MUA sole hub -node ment 1000 o E 


ontextHand las » ins 1 
yn. 0,.0,:4444 


AA 
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Step 3 : Now open the browser and navigate to the URL http//localhost:4444 
from the Hub (The system where you have executed Step+2). 


[* Selenium Grid2.0 help WN 


€ 3C IA sl localhost:4444 
CJ Shanz |) NewTab (7) Imported FromI£ $ Books247  ['] Service Desk 0] Ti 


You are using grid 2.42 2 
Find help on the official selenium wild : more help here 
default monitoring page : console 


Step 4 : Now click on the 'console' link and click "view config'. The config of the 
hub would be displayed as follows. As of now, we haven't got any nodes, hence 
we will not be able to see the details. 


ul Srid Console 


€ C ñ localhost:1444/: 


me, 
Se Grid Console v.2.42.2 


Config for the hub : 

host : null 

port : 4444 

cleanUpCycle : 5000 

timeout : 300000 

browserTimecut : 0 

newSessonwWaitTimeout : -1 

gndiMapping : £) 

throwOnCapabiityMNotPresent : true 

capabilityMatcher : org.openga.grid.mternal.utis DefaultCapabilityMatcher 


prionitizar ; mul 
sarviots : 


al ral 


browserTimeouyt : O 
capabilityMatcher : org.openga.grid.internal.utis DefaultCapabilityMatcher 
cleantipCycile : 5000 

host : null 

jettyMaxThreads : -1 

maxSession : $ 
newSessionWartTmeout : -1 
nodePolling : 5000 

nodeTimecut : 1000 

port; 4444 

prontizer ; mul 

role : hub 

serviets : [] 
throwOnCapabiltyNotPresent : true 
timeout : 300000 


Configuring the Nodes 


Step 1 : Logon to the node (where you would like to execute the scripts) and 
place the 'selenium-server-standalone-2.42.2' in a folder. We need to point to 
the selenium-server-standalone JAR while launching the nodes. 
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Step 2 : Launch FireFox Node using the following command. 


java -jar D:MJARAselenium-server-standalone-2.42.2.jar -role node -hub 
http://10.30.217.157:4444/grid/register -browser browserName=firefox - 
port 5555 


Where, 


D:MJARAselenium-server-standalone-2.42.2.jar = Location of the Selenium 
Server Standalone Jar File(on the Node Machine) 


http://10.30.217.157:4444 = IP Address of the Hub and 4444 is the port 
of the Hub 


browserName = firefox (Parameter to specify the Browser name on Nodes) 


5555 = Port on which Firefox Node would be up and running. 


P Adóress of the HUA 


Step 3 : After executing the command, come back to the Hub. Navigate to the 
URL - http://10.30.217.157:4444 and the Hub would now display the node 
attached to it. 


c fi ocalhost4 


Js 
E Grid Console v.2.42.2 


Erice A (version : 2.42.2) 
1410 5555, 0S ; 


FireFox Node is 
Connected in Port 5555 


5000 
300000 
Tmecut : 0 
nWaitTemeout : -1 
Andere $ 
owWDOnC Sn 3bDki HtyMNo! tPresent : true 
org.openga.gnd.mternal. utils DefaubtCapabldityMatcher 


170 


EH tutorialspoint 


A A II A AN EN pa 


Selenium 


Step 4: Now let us launch the Internet Explorer Node. For launching the IE 
Node, we need to have the Internet Explorer driver downloaded on the node 
machine. 


Step 5: To download the Internet Explorer driver, navigate to 
http://docs.seleniumhq.org/download/ and download the appropriate file based 
on the architecture of your OS. After you have downloaded, unzip the exe file 
and place it in a folder which has to be referred while launching IE nodes. 


S o is pago search sctonsam MO 
4 SeleniumHQ edit th soto 6 


Browser Automation Doventoad 


Downloads 


Below « where you can find the latest releases of all the Selermen components 
lI6t Ol pOrvI0s 1 aGeS, SONIC code, and additional information for Macan sera 
Java buñid tool 


Selenium IDE 


Mawan Informatica 
though they tand to bi 


Donate to Seleni a age O -y structure for army dond of re 


Dommioad latest released versión 1,5,0 released on 01/Jan/2014 or wen tie Relpase Motes and then 
wan PayPal natos soma al PP. 


1% DluOs 
Donate 
NO - SEE 
Mrorh porra he Wbdriver 0025. The 2,: server 5 2 drop replacement for the old Selenmmn AC server ant 15 
designed to be backwards compatible with your exating infrastructure 


Solenium Server (formerly the Selenium RC Server] 


The Salenium Seryer + needed m order to run ether Selensim AC style sonpts or Remote Selermn 


y 
Donmrnivad version 2.4 

recogrebon of your generaus AS 

contribution To us the Seleran Server in > Grid configurabon 526 15 00d 0395 


Selenium Sponsors The internet Explorer Driver Server 

See who supporta he Selec This ss required if you want to make use of the latest and greatest features of the WebOriver 

urnject InternetExplorerbnwver. Pluase make sure that tus 15 awallablo on your SPATH (or “PATH on 
Windows) m order for the 1E Driver to work as expected 


(o BrowserStack 1 pomnioad version 2.42.0 for (recommended) 22 bir Windows 15 or 64 bir Windows JE 


CHANGED 


Step 6 : Launch IE using the following command. 


C:W>java -Dwebdriver.ie.driver=D:IEDriverServer.exe -jar 
D:MJARAselenium-server-standalone-2.42.2.jar -role webdriver -hub 
http://10.30.217.157:4444/grid/register -browser 
browserName=ie,platform=WINDOWNS -port 5558 


Where, 


D:YIEDriverServer.exe = The location of the downloaded the IE Driver(on 
the Node Machine) 


D:XJARAselenium-server-standalone-2.42.2.jar = Location of the Selenium 
Server Standalone Jar File(on the Node Machine) 


http://10.30.217.157:4444 = IP Address of the Hub and 4444 is the port 
of the Hub 


browserName = ie (Parameter to specify the Browser name on Nodes) 


5558 = Port on which IE Node would be up and running. 
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MD Administrator CA Window system dPemdase > java Derebdriver re. dovera Di llDrareriarves. exe - par De A selermam- serves standalone-2,42, 2 jar «ros arebdraves hub .. 


JE Node is Started in 
port 5558 


Step 7 : After executing the command, come back to the Hub. Navigate to the 
URL - http://10.30.217.157:4444 and the Hub would now display the IE node 
attached to it. 


A 


E Moda ls h 
Connetted to Port 
155 


Step 8 : Let us now launch the Chrome Node. For launching the Chrome Node, 
we need to have the Chrome driver downloaded on the node machine. 


Step 9: To download the Chrome Driver, navigate to 
http://docs.seleniumhq.org/download/ and then navigate to Third Party Browser 
Drivers area and click on the version number '2.10' as shown below. 
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Third Party Drivers, Bindings, and Plugins 


Selenium can be extended through the use of plugins. Here are a number of plugins created and 
maintained by third parties. For more information on how to create your own plugin or have it listed, 
consult the docs. 


Please note that these plugins are not supported, maintained, hosted, or endorsed by the Selenium 
project, In addition, be advised that the plugins listed below are not necessarily licensed under the 
Apache License v.2.0. Some of the plugins are available under another free and open source software 
license; others are only available under a proprietary license. Any questions about plugins and their 
license of distribution need to be raised with their respective developer(s). 


Browser 
selenium wiki Released 2014- 


Chrome 


page 
GhostDriver (PhantomJS) SeConf talk 


Released 2013- 


Windows Phone 4.14.028.10 11-23 


Selendroid - Selenium for 
Android 


1os- driver 


Released 2014- 
BlackBerry 10 1 
BlackBerry 10 01-28 


Appium 


Released 2014- 


Crosswalk 05-05 


Step 10 : Download the driver based on the type of your OS. We will execute it 
on Windows environment, hence we will download the Windows Chrome Driver. 
After you have downloaded, unzip the exe file and place it in a folder which has 
to be referred while launching chrome nodes. 


Index of /2.10/ 


Name Last modified i ETag 


Parent Directory 


chromedriver_limux32.zip 2014-05-01 20:46:22 33N 4fecc99b066cbia346035bf02260710 


chromedriver_limix64 zip 2014-05-01 22:40:58 


chromedriver_win32 zip 


Step 11 : Launch Chrome using the following command. 


C:W>java -Dwebdriver.chrome.driver=D:Ychromedriver.exe -jar 
D:XJARAselenium-server-standalone-2.42.2.jar -role webdriver -hub 
http://10.30.217.157:4444/grid/register -browser 
browserName=chrome,platform=WINDOWS -port 5557 
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Where, 


D:Xchromedriver.exe = The location of the downloaded the chrome 
Driver(on the Node Machine) 


D:MJARAselenium-server-standalone-2.42.2.jar = Location of the Selenium 
Server Standalone Jar File(on the Node Machine) 


http://10.30.217.157:4444 = IP Address of the Hub and 4444 is the port 
of the Hub 


browserName = chrome (Parameter to specify the Browser name on Nodes) 


5557 = Port on which chrome Node would be up and running. 


MA Administrator: CAWindow yt 3 cmd ea > js «Dardos ceros der 005 hornear par DAJAR y edenurrdervar tarda lone-2 427 jar olé medie (3) Lal 


Chrome Node is 
connected to Pont 5657 


Step 12 : After executing the command, come back to the Hub. Navigate to the 
URL - http://10.30.217.157:4444 and the Hub would now display the chrome 
node attached to it. 


Creoma Drtyer aftachad to 
Hub 


Develop the Script and Prepare the XMIL File 


Step 1 : We will develop a test using TestNG. In the following example, we will 
launch each one of those browsers using remote WebDriver. It can pass on their 
capabilities to the driver so that the driver has all the information to execute on 
Nodes. 
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Selenium 


package TestNG; 


import 
import 
import 
import 
import 
import 
import 
import 


import 


import 


public 
1 


org.openqa.selenium.remote.DesiredCapabilities; 
java.util.concurrent.TimeUnit; 
org.openqa.selenium.*; 
org.testng.annotations.AfterTest; 
org.testng.annotations.BeforeTest; 
org.testng.annotations.Parameters; 
org.testng.annotations.Test; 

java.net.URL; 


java.net.MalformedURLException; 


org.openqa.selenium.remote.RemotelebDriver; 


class TestNGClass 


public WebDriver driver; 


public String URL, Node; 


protected ThreadLocal<RemotelWebDriver> threadDriver 


(AParameters("browser" ) 


MABeforeTest 


public void launchapp(String browser) throws MalformedURLException 


( 


String URL = "http://www.calculator.net"; 


if (browser.equalsIgnoreCase("firefox")) 


1 


System.out.println(" Executing on FireFox"); 


String Node = "http://10.112.66.52:5555/wd/hub" ; 


DesiredCapabilities cap = DesiredCapabilities.firefox(); 


cap.setBrowserName ("firefox"); 
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driver = new RemoteWebDriver(new URL(Node), cap); 
// Puts an Implicit wait, Will wait for 10 seconds 
// before throwing exception 
driver.manage().timeouts() 


.implicitlyWait(10, TimeUnit.SECONDS); 


// Launch website 
driver.navigate().to(URL); 


driver.manage().window().maximize(); 


ha 

else if (browser.equalsIgnoreCase("chrome")) 

1 
System.out.println(" Executing on CHROME"); 
DesiredCapabilities cap = DesiredCapabilities.chrome(); 
cap.setBrowserName("chrome"); 
String Node = "http://10.112.66.52:5557/wd/hub"; 
driver = new RemoteWebDriver(new URL(Node), cap); 
driver.manage().timeouts() 
.implicitlyWait(10, TimeUnit.SECONDS); 
//Launch website 
driver.navigate().to(URL); 
driver.manage().window().maximize(); 

Ñ 

else if (browser.equalsIgnoreCase("ie")) 

A 


System.out.printlin(" Executing on IE"); 
DesiredCapabilities cap = DesiredCapabilities.chrome(); 
cap.setBrowserName( "ie" 

String Node = "http://10.112.66.52:5558/wd/hub" ; 

driver = new RemoteWebDriver(new URL(Node), cap); 
driver.manage().timeouts() 


.implicitlyWait(10, TimeUnit.SECONDS); 
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//Launch website 
driver.navigate().to(URL); 


driver.manage().window().maximize(); 


J 
else 
Í 
throw new IllegalArgumentException 
("The Browser Type is Undefined"); 
J 
J 
ATest 


public void calculatepercent() 

í 
// Click on Math Calculators 
driver.findElement(By.xpath(".//*[Mid='menu']/div[3]/a")).click(); 


// Click on Percent Calculators 


driver.findElement(By.xpath(".//*[(Mid='menu']/div[4]/div[3]/a")).click(); 


// Enter value 18 in the first number of the percent Calculator 


driver.findElement(By.id("cpar1")).sendKeys("10"); 


// Enter value 50 in the second number of the percent Calculator 


driver.findElement(By.id("cpar2")).sendKeys("50"); 


// Click Calculate Button 
driver.findElement(By.xpath(".//*[(Mid='content']/table/tbody 
/tr/td[2]/input")).click(); 


// Get the Result Text based on its xpath 
String result = 


driver.findElement(By.xpath(".//*[Mid='content']/p[2] 
177 


EY) tutorialspoint 


Selenium 


/span/font/b")).getText(); 
// Print a Log In message to the screen 


System.out.println(" The Result is " + result); 


if(result.equals("5")) 


1 
System.out.printlin(" The Result is Pass"); 
y 
else 
1 
System.out.printlin(" The Result is Fail"); 
J 
J 
MAfterTest 


public void closeBrowser() 


( 


driver.quit(); 


Step 2 : The Browser parameter will be passed using XML. Create an XML under 
the project folder. 
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2 Java - TestNGDemo/testngxml - Eclipse 


avigate Search Projec lindow_ Help 
Alt+Shift+N » PP Java Project 
Project... 


Ctri+W | EY Package 
Close All Ctri+Shift+W y Class 


Save Ctrl+S aos 


la Save As... 
lla Save All Ctrl+Shift+S 
Revert 


Enum 
Annotation 
Source Folder 
Java Working Set 
Folder 


Rename... . 
File 


Refresh Untitled Text File 
Convert Line Delimiters To | E? JUnit Test Case 


Print... 


Switch Workspace 
Restart 


Import... 
Export... 


Properties Alt+Enter 


1 testng.xml [TestNGDemo] 

2 TestNiGClass.java [TestWGDemo/src...] 

3 index.html [TestNGDemo/test-output] 

4 Web Browser [D:/PERSONAL9%20DOCS/...] 


Exit 


Step 3 : Select 'File' from 'General' and click 'Next'. 


S New 
Select a wizard 


Create a new file resource 


Wizards: 
type filter text 
($ Class 
6 Interface 
(2£ Java Project 
E Java Project from Existing Ant Buildfile 
2 Plug-in Project 


[5 Project 
y Untitled Text File 


Finish Cancel 


Step 4 : Enter the name of the file and click 'Finish'. 
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3 New File 
File 


Create a new file resource. 


Enter or select the parent folder; 


TestNGDemo 


L TestNGDemo 


File name: testn.xml 


Advanced >> 


Step 5 : TestNg.XML is created under the project folder as shown below. 


a [2 TestNGDemo 
68 src 
E JRE System Library [JawaSE-1,8] 


- E, TestWiG 
mu, Referenced Libraries 


Step 6 : The contents of the XML file are shown below. We create 3 tests and 
put them in a suite and mention parallel="tests" so that all the tests would be 
executed in parallel. 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd"> 
<suite name="Suite" parallel="tests"> 
<test name="FirefoxTest"> 
<parameter name="browser" value="firefox" /> 
<classes> 


<class name="TestNG.TestNGClass" /> 
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</classes> 


</test> 


<test name="ChromeTest"> 
<parameter name="browser" value="chrome" /> 
<classes> 
<class name="TestNG.TestNGClass” /> 
</classes> 


</test> 


<test name="IETest"> 
<parameter name="browser" value="ie" /> 
<classes> 
<class name="TestNG.TestNGClass" /> 
</classes> 
</test> 


</suite> 


Test Execution 


Step 1 : Select the created XML; right-click and choose 'Run As' >> 'TestNG 
Suite". 
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File Edit Source Refactor Navigate Search Project Run Window Help 
RAI ES LD A AM 


ackage Explorer Eg 3 Me: ngxm 
ES Package Explorer 52 | OE 20 testngaml 53 
O selrcdemo 1<?xml version="1.0" encoding="UTF-8”>?> 
a EY TestNGDemo 2 <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.8.dtd"> 
Eb src 3<suite name="Suite"” parallel="tests"> 
3 , Ñ <test name="FirefoxTest”> 
» má JRE System Library [lavaSE-1,8] <parameter name="browser" value="firefox” /> 
> BL TestNiG <classes> 
> Ex) Referenced Libraries <class name="TestNG.TestNGClass” /> 
, E test-output </classes> 
RRE </test> 


[E testngpml! 
U WebDrive New > 


o 5 name="ChromeTest"> 
Lio brameter name="browser” value="chrome" /> 
Open With » fasses> 
O AlteShift+W > h <class name="TestNG.TestNGClass” /> 
asses> 


Copy Ctrl+ E 
Copy Qualified Name 
name="IETest"> 


Paste Ctrl+V 4 2 a 
rameter name="browser" value="ie" /> 
Delete Delete asses> 
<class name="TestWG.TestNGClass” /> 
Build Path > [lasses> 


Refactor Alt+Shift+T» P 


xo de Um 


Import... 
Export... 


Refresh 
Assign Working Sets... 


bug A 
DUO AS 


De > 
AA IST 
eam 


Run Configurations... 
Compare With » 


Replace With » 


TestNG » 


Properties Alt+Enter 
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Step 2 : Now open the Node, where we have launched all the browser nodes. 
You will see all the three browsers in execution simultaneously. 


Tanta Executrig on jo Calculators 
FeePaor 2 


Weight Luna Calcalanaa — Paper Cor cierra 


Tests Executitg on 
Corema 


es LL tego de 


Calculator.net 


Free Online Calculators 


> Tests Executing ont É 


Calculator.net 


Free Online Calculators 


Result Analysis 


Step 1: Upon completing the execution, we can analyze the result like any 
other execution. The result summary is printed in the console as shown in the 


following snapshot. 


[27 Problems (1 Javadoc [es Declaration Ñ Results of running suite [E] Console ¿3 
<terminated> testng.xml [TestNG] CAProgram Files Java'jre8bin'javaw.exe (2 Aug 2014 8:25:04 am) 


[TestNG] Running: 


D: PERSONAL DOCS1Selenium Trials1TestNGDemotestng.xml 


Executing on FireFox 
Executing on IE 
Executing on CHROME 
The Result is 5 
The Result is Pass 
The Result is 

Result i 

Result i 

Result i 


run: 3, Failures: 0, Skips: 


E) tutorialspoint 


183 


Selenium 


Step 2: Navigate to the 'Results of Running Suite' Tab and TestNG would 
display the result summary as shown below. 


tanta el nur ruta 


Diaumdi Utandt Loppet O 


¡Pam tests ¡Herpes Testo rrenary 


EEE TEE 


a bj Ivana ter cl 0 1 br" 
a dls Vet TertiGI e FireFox Test 
Res 


li calacetepecara 14300 d 


a dis Fate Tes 1 12381 
a iy tertó00 terÓC1 a 
al tado later LIM $ 
a Hi ME et (AA E Test Result 
a di TestiG TemGCIas 
his calcutatapincare ASI a) a 


Step 3 : Upon generating the HTML, we will be able to see the test results in 
HTML format. 


tnttraré d A pot 
- Has [DSPURILIMAL IDO CA alar 2d Urra Y et DD ete crtp rt res herrál 


All suites 


f Suite | FuefonTest (1 class) 
CietmmeTes (1 ela) 
TETest ¿1 lem) 


ISONAL DOCS Selerszz Usable Tartas terna xd > 
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